com.atlassian.crowd.manager.property

Class PropertyManagerGeneric

java.lang.Object

com.atlassian.crowd.manager.property.PropertyManagerGeneric

All Implemented Interfaces:

PropertyManager

public class PropertyManagerGeneric
extends Object
implements PropertyManager

Constructor Summary

Constructors

Constructor and Description
PropertyManagerGeneric(PropertyDAO propertyDAO)

Method Summary

Methods

Modifier and Type	Method and Description
void	generateDesEncryptionKey() Generates and stores a DES key for DES encoded passwords.
Integer	getBuildNumber() This method returns the current build number for Crowd from the datastore.
long	getCacheTime() Returns the cache time in minutes
int	getCurrentLicenseResourceTotal()
String	getDeploymentTitle()
Key	getDesEncryptionKey()
String	getDomain() Will return the Domain property from the datastore or null if the domain has not been set.
String	getNotificationEmail()
String	getProperty(String name) Retrieves an arbitrary property by name.
protected Property	getPropertyObject(String name)
long	getSessionTime()
SMTPServer	getSMTPServer()
String	getSMTPTemplate() Deprecated.
String	getTokenSeed()
String	getTrustedProxyServers() Retrieves a String that contains a list of proxy servers we trust to correctly set the X-Forwarded-For flag.
boolean	isCacheEnabled()
boolean	isGzipEnabled()
boolean	isIncludeIpAddressInValidationFactors() Should the client IP address be included as a validation factor?
boolean	isSecureCookie()
boolean	isUsingDatabaseTokenStorage() Will return true if the Crowd instance is using database token storage for authentication Token's otherwise assume we are using in-memory
void	removeProperty(String name) Will attempt to remove a property from the datastore
void	setBuildNumber(Integer buildNumber) Will set the buildNumber for the current release of Crowd.
void	setCacheEnabled(boolean enabled)
void	setCacheTime(long cacheTime) Sets the cache time in minutes
void	setCurrentLicenseResourceTotal(int total)
void	setDeploymentTitle(String title)
void	setDomain(String domain)
void	setGzipEnabled(boolean gzip)
void	setIncludeIpAddressInValidationFactors(boolean includeIpAddressInValidationFactors)
void	setNotificationEmail(String notificationEmail)
void	setProperty(String name, String value) Sets an arbitrary property.
void	setSecureCookie(boolean secure)
void	setSessionTime(long time)
void	setSMTPServer(SMTPServer server)
void	setSMTPTemplate(String template) Deprecated.
void	setTokenSeed(String seed)
void	setTrustedProxyServers(String proxyServers) Persists a String containing a list of proxy servers we trust to correctly set the X-Forwarded-For flag.
void	setUsingDatabaseTokenStorage(boolean usingMemoryTokenStorage) Will set a property to state that this crowd instance is using database token storage, otherwise assume we are using in-memory

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertyManagerGeneric

public PropertyManagerGeneric(PropertyDAO propertyDAO)

Method Detail

getCacheTime

public long getCacheTime()
                  throws PropertyManagerException

Description copied from interface: PropertyManager

Returns the cache time in minutes

Specified by:

getCacheTime in interface PropertyManager

Returns:

caching time in minutes

Throws:

PropertyManagerException - if the property cannot be found

setCacheTime

public void setCacheTime(long cacheTime)

Description copied from interface: PropertyManager

Sets the cache time in minutes

Specified by:

setCacheTime in interface PropertyManager

Parameters:

cacheTime - the caching time in minutes

getTokenSeed

public String getTokenSeed()
                    throws PropertyManagerException

Specified by:

getTokenSeed in interface PropertyManager

Returns:

token seed.

Throws:

PropertyManagerException - property does not exist.

setTokenSeed

public void setTokenSeed(String seed)

Specified by:

setTokenSeed in interface PropertyManager

Parameters:

seed - token seed.

getDeploymentTitle

public String getDeploymentTitle()
                          throws PropertyManagerException

Specified by:

getDeploymentTitle in interface PropertyManager

Returns:

deployment title.

Throws:

PropertyManagerException - property does not exist.

setDeploymentTitle

public void setDeploymentTitle(String title)

Specified by:

setDeploymentTitle in interface PropertyManager

Parameters:

title - deployment title.

getDomain

public String getDomain()
                 throws PropertyManagerException

Description copied from interface: PropertyManager

Will return the Domain property from the datastore or null if the domain has not been set.

Specified by:

getDomain in interface PropertyManager

Returns:

domain or null

Throws:

PropertyManagerException - property does not exist.

setDomain

public void setDomain(String domain)

Specified by:

setDomain in interface PropertyManager

Parameters:

domain - SSO cookie domain.

isSecureCookie

public boolean isSecureCookie()

Specified by:

isSecureCookie in interface PropertyManager

Returns:

true if the "secure" flag should be set on the SSO cookie.

setSecureCookie

public void setSecureCookie(boolean secure)

Specified by:

setSecureCookie in interface PropertyManager

Parameters:

secure - true if the "secure" flag should be set on the SSO cookie.

setCacheEnabled

public void setCacheEnabled(boolean enabled)

Specified by:

setCacheEnabled in interface PropertyManager

Parameters:

enabled - true if application authorisation caching should be used on the server-side.

isCacheEnabled

public boolean isCacheEnabled()

Specified by:

isCacheEnabled in interface PropertyManager

Returns:

true if application authorisation caching is used on the server-side.

getSessionTime

public long getSessionTime()

Specified by:

getSessionTime in interface PropertyManager

Returns:

number of minutes the session is valid.

setSessionTime

public void setSessionTime(long time)

Specified by:

setSessionTime in interface PropertyManager

Parameters:

time - number of minutes the session is valid.

getSMTPServer

public SMTPServer getSMTPServer()
                         throws PropertyManagerException

Specified by:

getSMTPServer in interface PropertyManager

Returns:

SMTP server config.

Throws:

PropertyManagerException - property does not exist.

setSMTPServer

public void setSMTPServer(SMTPServer server)

Specified by:

setSMTPServer in interface PropertyManager

Parameters:

server - SMTP server config.

getDesEncryptionKey

public Key getDesEncryptionKey()
                        throws PropertyManagerException

Specified by:

getDesEncryptionKey in interface PropertyManager

Returns:

DES key for DES encoded passwords.

Throws:

PropertyManagerException - property does not exist.

generateDesEncryptionKey

public void generateDesEncryptionKey()
                              throws PropertyManagerException

Description copied from interface: PropertyManager

Generates and stores a DES key for DES encoded passwords.

Specified by:

generateDesEncryptionKey in interface PropertyManager

Throws:

PropertyManagerException - DES algorithm does not exist.

setSMTPTemplate

@Deprecated
public void setSMTPTemplate(String template)

Deprecated.

Specified by:

setSMTPTemplate in interface PropertyManager

Parameters:

template - mail template.

getSMTPTemplate

@Deprecated
public String getSMTPTemplate()
                       throws PropertyManagerException

Deprecated.

Specified by:

getSMTPTemplate in interface PropertyManager

Returns:

mail template.

Throws:

PropertyManagerException - property does not exist.

setCurrentLicenseResourceTotal

public void setCurrentLicenseResourceTotal(int total)

Specified by:

setCurrentLicenseResourceTotal in interface PropertyManager

Parameters:

total - license resource total.

getCurrentLicenseResourceTotal

public int getCurrentLicenseResourceTotal()

Specified by:

getCurrentLicenseResourceTotal in interface PropertyManager

Returns:

license resource total.

setNotificationEmail

public void setNotificationEmail(String notificationEmail)

Specified by:

setNotificationEmail in interface PropertyManager

Parameters:

notificationEmail - notification email.

getNotificationEmail

public String getNotificationEmail()
                            throws PropertyManagerException

Specified by:

getNotificationEmail in interface PropertyManager

Returns:

notification email.

Throws:

PropertyManagerException - property does not exist.

isGzipEnabled

public boolean isGzipEnabled()
                      throws PropertyManagerException

Specified by:

isGzipEnabled in interface PropertyManager

Returns:

true if GZip compression should be used.

Throws:

PropertyManagerException - property does not exist.

setGzipEnabled

public void setGzipEnabled(boolean gzip)

Specified by:

setGzipEnabled in interface PropertyManager

Parameters:

gzip - true if GZip compression should be used.

getBuildNumber

public Integer getBuildNumber()
                       throws PropertyManagerException

Description copied from interface: PropertyManager

This method returns the current build number for Crowd from the datastore. This BuildNumber may not be the same as the build number in BuildUtils.BUILD_NUMBER since this number is for the current release of Crowd, while the number in the database may still be set to a previous version if the UpgradeManager has not been run.

Specified by:

getBuildNumber in interface PropertyManager

Returns:

an Integer representing the current build number in the database.

Throws:

PropertyManagerException - if we fail to find the buildNumber

setBuildNumber

public void setBuildNumber(Integer buildNumber)

Description copied from interface: PropertyManager

Will set the buildNumber for the current release of Crowd.

Specified by:

setBuildNumber in interface PropertyManager

Parameters:

buildNumber - the buildNumber to set in the database

getTrustedProxyServers

public String getTrustedProxyServers()
                              throws PropertyManagerException

Retrieves a String that contains a list of proxy servers we trust to correctly set the X-Forwarded-For flag. Internal format of this string is the responsibility of TrustedProxyManagerImpl.

Specified by:

getTrustedProxyServers in interface PropertyManager

Returns:

list of proxy servers we trust

Throws:

PropertyManagerException - If the list of proxy servers could not be found.

setTrustedProxyServers

public void setTrustedProxyServers(String proxyServers)

Persists a String containing a list of proxy servers we trust to correctly set the X-Forwarded-For flag. Internal format of this string is the responsibility of TrustedProxyManagerImpl.

Specified by:

setTrustedProxyServers in interface PropertyManager

Parameters:

proxyServers - proxy servers.

Throws:

org.springframework.dao.DataAccessException - If the list of proxy servers could not be saved.

isUsingDatabaseTokenStorage

public boolean isUsingDatabaseTokenStorage()
                                    throws PropertyManagerException

Description copied from interface: PropertyManager

Will return true if the Crowd instance is using database token storage for authentication Token's otherwise assume we are using in-memory

Specified by:

isUsingDatabaseTokenStorage in interface PropertyManager

Returns:

true if database token storage is being used.

Throws:

PropertyManagerException - property does not exist.

setUsingDatabaseTokenStorage

public void setUsingDatabaseTokenStorage(boolean usingMemoryTokenStorage)

Description copied from interface: PropertyManager

Will set a property to state that this crowd instance is using database token storage, otherwise assume we are using in-memory

Specified by:

setUsingDatabaseTokenStorage in interface PropertyManager

Parameters:

usingMemoryTokenStorage - true if you are switching to in-memory token storage

isIncludeIpAddressInValidationFactors

public boolean isIncludeIpAddressInValidationFactors()

Description copied from interface: PropertyManager

Should the client IP address be included as a validation factor?

Specified by:

isIncludeIpAddressInValidationFactors in interface PropertyManager

setIncludeIpAddressInValidationFactors

public void setIncludeIpAddressInValidationFactors(boolean includeIpAddressInValidationFactors)

Specified by:

setIncludeIpAddressInValidationFactors in interface PropertyManager

removeProperty

public void removeProperty(String name)

Description copied from interface: PropertyManager

Will attempt to remove a property from the datastore

Specified by:

removeProperty in interface PropertyManager

Parameters:

name - the name of the property.

getPropertyObject

protected Property getPropertyObject(String name)
                              throws ObjectNotFoundException

Throws:

ObjectNotFoundException

getProperty

public String getProperty(String name)
                   throws ObjectNotFoundException

Description copied from interface: PropertyManager

Retrieves an arbitrary property by name.

Specified by:

getProperty in interface PropertyManager

Parameters:

name - name of property.

Returns:

value.

Throws:

ObjectNotFoundException - property does not exist.

setProperty

public void setProperty(String name,
               String value)

Description copied from interface: PropertyManager

Sets an arbitrary property.

Specified by:

setProperty in interface PropertyManager

Parameters:

name - name of property.

value - value.