com.novell.nds.dirxml.shimhost

Class ShimState

java.lang.Object

com.novell.nds.dirxml.shimhost.ShimState

All Implemented Interfaces:

ConfigElement

public class ShimState
extends java.lang.Object
implements ConfigElement

Encapsulation of "driver state" information stored on behalf of application shims.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DRIVER Parameter value for getState() method indicating DriverShim state.
static int	PUBLISHER Parameter value for getState() method indicating PublicationShim state.
static int	SUBSCRIBER Parameter value for getState() method indicating SubscriptionShim state.
static java.lang.String	TAG_SHIM_STATE Tag name of "shim-state" element.

Constructor Summary

Constructors

Constructor and Description
ShimState() Construct an empty ShimState instance.
ShimState(org.w3c.dom.Element shimState) Construct a ShimState instance from a <shim-state> element.

Method Summary

Modifier and Type	Method and Description
org.w3c.dom.Element	getDriverState() Get the DriverShim state.
org.w3c.dom.Element	getPublisherState() Get the PublicationShim state
org.w3c.dom.Element	getState(int which) Return state for one of the shims.
org.w3c.dom.Element	getSubscriberState() Get the SubscriptionShim state
boolean	hasBeenModified() Return true if this instance has been modified.
void	resetModified() Reset the modified flag for this instance such that hasBeenModified() will return false.
void	serializeXML(java.io.OutputStream os) Serialize the shim state data as an XML document.
void	setDriverState(org.w3c.dom.Element newDriverState) Set the DriverShim state.
void	setPublisherState(org.w3c.dom.Element newPublisherState) Set the PublicationShim state.
void	setSubscriberState(org.w3c.dom.Element newSubscriberState) Set the SubscriptionShim state.
org.w3c.dom.Element	toXML(org.w3c.dom.Node parent) Construct an XML representation of this ShimState instance Note that the act of creating an XML representation does not reset this instance's modified flag.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TAG_SHIM_STATE

public static final java.lang.String TAG_SHIM_STATE

Tag name of "shim-state" element.

See Also:

Constant Field Values

DRIVER

public static final int DRIVER

Parameter value for getState() method indicating DriverShim state.

See Also:

getState(int), Constant Field Values

SUBSCRIBER

public static final int SUBSCRIBER

Parameter value for getState() method indicating SubscriptionShim state.

See Also:

getState(int), Constant Field Values

PUBLISHER

public static final int PUBLISHER

Parameter value for getState() method indicating PublicationShim state.

See Also:

getState(int), Constant Field Values

Constructor Detail

ShimState

public ShimState()

Construct an empty ShimState instance.

ShimState

public ShimState(org.w3c.dom.Element shimState)

Construct a ShimState instance from a <shim-state> element.

Parameters:

shimState - <shim-state> element

Method Detail

hasBeenModified

public boolean hasBeenModified()

Return true if this instance has been modified.

The instance is considered to have been modified if a change was made that affects the persistent representation since:

1. The instance was constructed from an XML representation.
2. resetModified() was last called

Specified by:

hasBeenModified in interface ConfigElement

Returns:

true or false

See Also:

resetModified(), toXML(org.w3c.dom.Node)

resetModified

public void resetModified()

Reset the modified flag for this instance such that hasBeenModified() will return false.

Specified by:

resetModified in interface ConfigElement

See Also:

hasBeenModified()

toXML

public org.w3c.dom.Element toXML(org.w3c.dom.Node parent)

Construct an XML representation of this ShimState instance

Note that the act of creating an XML representation does not reset this instance's modified flag. It must be reset by calling resetModified().

Specified by:

toXML in interface ConfigElement

Parameters:

parent - Node under which to build XML representation

Returns:

constructed <shim-state> element

See Also:

hasBeenModified(), resetModified()

serializeXML

public void serializeXML(java.io.OutputStream os)
                  throws java.io.IOException

Serialize the shim state data as an XML document. Serialized using UTF-8 encoding.

Parameters:

os - OutputStream to which to serialize.

Throws:

java.io.IOException - if error occurs writing to OutputStream

getState

public org.w3c.dom.Element getState(int which)
                             throws java.lang.IllegalArgumentException

Return state for one of the shims.

Parameters:

which - DRIVER, SUBSCRIBER, or PUBLISHER

Returns:

state Element

Throws:

java.lang.IllegalArgumentException - if which is incorrect

getDriverState

public org.w3c.dom.Element getDriverState()

Get the DriverShim state.

Returns:

<driver-state> element

setDriverState

public void setDriverState(org.w3c.dom.Element newDriverState)
                    throws java.lang.IllegalArgumentException

Set the DriverShim state.

Parameters:

newDriverState - <driver-state element

Throws:

java.lang.IllegalArgumentException - if parameter doesn't have the correct name, or is null.

getSubscriberState

public org.w3c.dom.Element getSubscriberState()

Get the SubscriptionShim state

Returns:

<subscriber-state> element

setSubscriberState

public void setSubscriberState(org.w3c.dom.Element newSubscriberState)
                        throws java.lang.IllegalArgumentException

Set the SubscriptionShim state.

Parameters:

newSubscriberState - <subscriber-state element

Throws:

java.lang.IllegalArgumentException - if parameter doesn't have the correct name, or is null.

getPublisherState

public org.w3c.dom.Element getPublisherState()

Get the PublicationShim state

Returns:

<publisher-state> element

setPublisherState

public void setPublisherState(org.w3c.dom.Element newPublisherState)
                       throws java.lang.IllegalArgumentException

Set the PublicationShim state.

Parameters:

newPublisherState - <publisher-state element

Throws:

java.lang.IllegalArgumentException - if parameter doesn't have the correct name, or is null.