|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Version
A version of an object that is Versionable
. A Versionable object can
have a collection of Versions. For example, a Domain object can have a
collection of DomainVersions. The data associated with a particular version
is stored in the Version object instead of the Versionable object.
A Version should have several attributes.
Blob
.
During debug and troubleshooting, it may be helpful to obtain a copy of the
Blob
as returned from getBlob()
if there is a question if
the Blob attached to this version is different from what is persisted on the
device and how it interacts in
Commands.isDomainDifferent(String, byte[], byte[], com.ibm.datapower.wamt.amp.DeviceContext)
Beware that the Blob file may be Base64 encoded in the repository, depending
on the implementation of Commands
and
Repository
that is being used, the
default implementation does store the Blob as Base64 encoded, so you will
need to Base64 decode the file before using it in the WebGUI. For a Blob in:
DomainVersion
other than the domain named "default": that Blob
is the same as if you had created a "Backup Zip Bundle" from the WebGUI. So
you can use the WebGUI "Compare Configuration" operation on that Blob file.
First do a Base64 decode and then give the filename a ".zip" extension and
attach it on one side on the Comparison. On the other side of the Comparison
select "Persisted Configuration".
DomainVersion
in the default domain: since the Settings
were stripped out of the export of this domain compared to what you would get
from the WebGUI's export, you will need to unzip this file and pull out the
inner file named "export.xml". Then in the WebGUI "Compare Configuration"
select "XML Configuration" and attach the "export.xml" file on one side, and
on the other side of the Comparison select "Persisted Configuration".
FirmwareVersion
: there is no direct comparison for firmware
files, simply use the firmware level String from the running device via
Commands.getDeviceMetaInfo(com.ibm.datapower.wamt.amp.DeviceContext)
or from the firmware file via FirmwareVersion.getLevel()
.
Versionable
Field Summary | |
---|---|
static java.lang.String |
COPYRIGHT_2009_2010
|
static java.lang.String |
SCM_REVISION
|
Method Summary | |
---|---|
Blob |
getBlob()
Get the Blob that is attached to this Version. |
java.util.Date |
getTimestamp()
Get the timestamp that signifies when the Version was created in the Manager. |
java.lang.String |
getUserComment()
Get the user comment that corresponds to this Version. |
Versionable |
getVersionedObject()
Get a reference to the object that this Version is a version of. |
int |
getVersionNumber()
Get the version number that this Version object represents. |
void |
setUserComment(java.lang.String userComment)
This is the method to set the user comment that can be later retrieved via getUserComment() . |
Field Detail |
---|
static final java.lang.String COPYRIGHT_2009_2010
static final java.lang.String SCM_REVISION
Method Detail |
---|
int getVersionNumber() throws DeletedException
setVersionNumber(int)
method. The combination
of version number and Object reference forms the primary key for a
Version object in the Manager.
Versionable getVersionedObject() throws DeletedException
DomainVersion.getVersionedObject()
should
return a Domain
, which is the parent object. This should
be a reminder for the subclass to implement the method getDomain()
or getFirmware() that would return a typed object instead
of a generic one. It isn't expected that a caller would actually use this
method.
java.util.Date getTimestamp() throws DeletedException
setTimestamp(Date)
method.
java.lang.String getUserComment() throws DeletedException
setUserComment(String)
void setUserComment(java.lang.String userComment) throws DatastoreException, LockBusyException, DeletedException
getUserComment()
. Calling this method will cause the
comment to be written to the persisted datastore.
userComment
- the user-defined comment to attach to this Version. It may
have reference to a new function, bug fix, change management or
problem management ticket, etc. This is a freeform field of
unlimited length.getUserComment()
Blob getBlob() throws DeletedException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |