com.nitido.nimx.nuggets.iplanetset.userspace
Class IPlanetSettingsNuggetImpl

java.lang.Object
  com.nitido.nim.Nugget
      com.nitido.nim.NonCachableNugget
          com.nitido.nimx.nuggets.iplanetset.IPlanetSettingsNugget
              com.nitido.nimx.nuggets.iplanetset.userspace.IPlanetSettingsNuggetImpl

All Implemented Interfaces:

CredentialConstants, java.io.Serializable

public class IPlanetSettingsNuggetImpl
extends IPlanetSettingsNugget

IPlanetSettingsNugget is responsible for accessing and modifying personal preference settings that may involve more than one iPlanet servers.

Settings This implementation does not require any settings. It simply stores all the setting to the user space. If these settings are stored in the backend, you must ensure the corresponding DataControlService has been configured properly to map these settings to the backend.

See Also:

Serialized Form

Field Summary

protected java.util.HashMap	_cachedAttr
protected OpenHash	_modifyAttr
protected java.util.HashSet	_removeAttr
protected int	_transactionLevel

Fields inherited from class com.nitido.nim.Nugget

_entity, _nim, _nuggetName, _settings

Fields inherited from interface com.nitido.nim.CredentialConstants

CRED_ADMIN, CRED_CONTAINER, CRED_HELPDESK, CRED_SYSTEM, CRED_USER, KEY_PASSWORD

Constructor Summary

IPlanetSettingsNuggetImpl(NuggetVisa visa)
Default Nugget constructor.

Method Summary

void	abortTransaction() Abort a batch of settings change.
void	activate() Used by NiM Nugget mechanism.
void	commitTransaction() Commits a batch of settings change.
void	deactivate() Used by NiM Nugget mechnanism.
java.lang.String	getDescriptor() Used by NiM Nugget mechnanism.
java.lang.String[]	getMultiValues(java.lang.String attribute) Returns all values of the attribute in the user's entry.
protected void	initImpl() This method is called by the init() method after the member variables _nuggetName, _entity and _settings are assigned.
protected void	removeMultiValues(java.lang.String attribute) Removes the specified attribute from the user's entry.
void	setMultiValues(java.lang.String attribute, java.lang.String[] values) Sets the attribute/value for the user's entry in the Directory.
void	setSingleValue(java.lang.String attribute, java.lang.String value) Sets the attribute/value pair for the user's entry in the Directory.
void	startTransaction() Starts a batch of settings change.

Methods inherited from class com.nitido.nimx.nuggets.iplanetset.IPlanetSettingsNugget

addFilter, arrayToVector, checkInt, checkNonNull, containsValue, createUniqueArray, getCommonName, getComposeTextSize, getComposeWidth, getCopyForward, getCopyForwardEnabled, getCopySend, getExtendedCalendarPref, getExtendedMailPref, getExtendedPref, getExternalMailSetting, getFilters, getNotificationEmailAddress, getNotificationFrom, getNotificationListOption, getNotificationOption, getNotificationPhoneFrom, getNotificationPhoneListOption, getNotificationPhoneNumber, getNotificationPhoneOption, getNotificationPhoneUrgentOption, getNotificationUrgentOption, getPaginationSize, getReplyInclude, getReplyTo, getSignature, getSignatureEnabled, getSingleValue, getVacationMessageEnabled, getVacationMessageEndDate, getVacationMessageExternal, getVacationMessageInternal, getVacationMessageRepeatDays, getVacationMessageStartDate, getVacationMessageSubject, getVCard, getVCardEnabled, isExtendedMailPrefTrue, isLegalNotificationOption, removeExtendedPref, removeStringFromArray, replaceStringInArray, setBooleanExtendedMailPref, setCommonName, setComposeTextSize, setComposeWidth, setCopyForward, setCopyForwardEnabled, setCopySend, setExtendedCalendarPref, setExtendedMailPref, setExtendedPref, setExternalMailSetting, setFilters, setNotificationEmailAddress, setNotificationFrom, setNotificationListOption, setNotificationOption, setNotificationPhoneFrom, setNotificationPhoneListOption, setNotificationPhoneOption, setNotificationPhoneUrgentOption, setNotificationUrgentOption, setPaginationSize, setReplyInclude, setReplyTo, setSignature, setSignatureEnabled, setVacationMessageEnabled, setVacationMessageExternal, setVacationMessageInternal, setVacationMessageRepeatDays, setVacationMessageSubject, setVCard, setVCardEnabled, vectorToArray

Methods inherited from class com.nitido.nim.NonCachableNugget

isCachable

Methods inherited from class com.nitido.nim.Nugget

destroy, destroyImpl, getEntity, getNuggetName, getSetting, getSettings, init, requestBegin, requestEnd

Methods inherited from class java.lang.Object

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

Field Detail

_modifyAttr

protected transient OpenHash _modifyAttr

_removeAttr

protected transient java.util.HashSet _removeAttr

_cachedAttr

protected transient java.util.HashMap _cachedAttr

_transactionLevel

protected transient int _transactionLevel

Constructor Detail

IPlanetSettingsNuggetImpl

public IPlanetSettingsNuggetImpl(NuggetVisa visa)

Default Nugget constructor.

Method Detail

activate

public void activate()
              throws ActivationException

Used by NiM Nugget mechanism. An application developer should never invoke this.

Overrides:

activate in class IPlanetSettingsNugget

Throws:

ActivationException - If unable to activate the Nugget

deactivate

public void deactivate()
                throws ActivationException

Used by NiM Nugget mechnanism. An application developer should never invoke this.

Overrides:

deactivate in class IPlanetSettingsNugget

Throws:

ActivationException - If unable to deactivate the Nugget

initImpl

protected void initImpl()
                 throws InitializationFailedException,
                        InvalidSettingException

Description copied from class: Nugget

This method is called by the init() method after the member variables _nuggetName, _entity and _settings are assigned. This method allows nugget implementations to put in code for initializing itself.

Specified by:

initImpl in class Nugget

Throws:

InitializationFailedException - If unable to initialize the nugget with the given parameters.

InvalidSettingException - If any of the expected initialization settings are null.

getDescriptor

public java.lang.String getDescriptor()

Used by NiM Nugget mechnanism. An application developer should never invoke this.

Overrides:

getDescriptor in class IPlanetSettingsNugget

Returns:

The string with the description of the Nugget.

setSingleValue

public void setSingleValue(java.lang.String attribute,
                           java.lang.String value)
                    throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Sets the attribute/value pair for the user's entry in the Directory. Any existing values will be removed (i.e. this is a "replace" instead of "add".)

Specified by:

setSingleValue in class IPlanetSettingsNugget

Parameters:

attribute - The attribute name

value - The new value.

Throws:

IPlanetServerException - If there is a connection problem with the Directory object.

getMultiValues

public java.lang.String[] getMultiValues(java.lang.String attribute)
                                  throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Returns all values of the attribute in the user's entry.

Note: if the attribute has only one value stored, it simply returns an array of size one no matter whether the underlying attribute is single-value or multi-values.

Specified by:

getMultiValues in class IPlanetSettingsNugget

Returns:

values Array of values associated with attribute. If the attribute has no value, it will return a String array of size 0.

Throws:

IPlanetServerException - If there is a connection problem with the Directory object.

setMultiValues

public void setMultiValues(java.lang.String attribute,
                           java.lang.String[] values)
                    throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Sets the attribute/value for the user's entry in the Directory. Any existing values will be removed (i.e. this is a "replace" instead of "add".)

Specified by:

setMultiValues in class IPlanetSettingsNugget

Parameters:

attribute - The attribute name

values - The new values.

Throws:

IPlanetServerException - If there is a connection problem with the Directory object.

removeMultiValues

protected void removeMultiValues(java.lang.String attribute)
                          throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Removes the specified attribute from the user's entry.

Specified by:

removeMultiValues in class IPlanetSettingsNugget

Throws:

IPlanetServerException - If there is a connection problem with the Directory object.

startTransaction

public void startTransaction()
                      throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Starts a batch of settings change. If you need to set/get a number of attributes in a row, you should invoke this method before the calls.

Please see the class description for more details on why and when to use these transaction methods.

Specified by:

startTransaction in class IPlanetSettingsNugget

Throws:

IPlanetServerException

commitTransaction

public void commitTransaction()
                       throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Commits a batch of settings change. If you need to set/get a number of attributes in a row, you should use this method after the calls.

Please see the class description for more details on why and when to use these transaction methods.

Specified by:

commitTransaction in class IPlanetSettingsNugget

Throws:

IPlanetServerException

abortTransaction

public void abortTransaction()
                      throws IPlanetServerException

Description copied from class: IPlanetSettingsNugget

Abort a batch of settings change. This method will drop the transaction and LDAP connection. All setXXX changes after the startTransaction() method call will be lost. This method is is usually called when the application encountered an exception and need to drop the transaction.

If no transaction was in process when this method is called, this method will not do anything and no exception will be thrown.

Please see the class description for more details on why and when to use these transaction methods.

Specified by:

abortTransaction in class IPlanetSettingsNugget

Throws:

IPlanetServerException