de.innovationgate.webgate.api.simple

Class BeanAdapter

java.lang.Object

de.innovationgate.webgate.api.templates.SimpleContentSource

de.innovationgate.webgate.api.simple.BeanAdapter

All Implemented Interfaces:

WGDatabaseCore

public class BeanAdapter
extends SimpleContentSource

A simple content source that retrieves data from a custom Java bean

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COPTION_BEAN_JARFILE
static java.lang.String	COPTION_CREATION_HANDLER
static java.lang.String	COPTION_ONE_BEAN_PER
static java.lang.String	COPTION_ONE_BEAN_PER_DB
static java.lang.String	COPTION_ONE_BEAN_PER_REQUEST
static java.lang.String	COPTION_ONE_BEAN_PER_USER
static int	ONE_BEAN_PER_DB
static int	ONE_BEAN_PER_REQUEST
static int	ONE_BEAN_PER_USER
static java.lang.String	USER_BEAN

Fields inherited from class de.innovationgate.webgate.api.templates.SimpleContentSource

COPTION_LANGUAGE, DUMMY_AREA

Constructor Summary

Constructors

Constructor and Description
BeanAdapter()

Method Summary

Methods

Modifier and Type	Method and Description
java.util.Map	browse(java.lang.String folder) Browses the given folder for contents.
java.lang.Object	convertToKey(java.lang.String key, java.lang.String folder) Converts the string representation of a data key to it's real data type.
java.lang.Object	createContent(java.lang.String folder) Creates a new content object in the given folder
void	destroy() Callback method, that gets called when the SCS is closed completely.
java.util.Map	find(java.lang.String folder, java.lang.String query, java.util.Map parameters) Used to implement querying behaviour to the SCS implementation.
java.lang.Object	getContent(java.lang.String folder, java.lang.Object key) Implement to retrieve a single data object by key information.
java.util.Date	getCreated()
WGDatabase	getDB()
WGDocumentCore	getDummyContent(java.lang.String language) Creates a "dummy content" object, that is used, when rendering WebTML without a content context.
java.lang.String[]	getFolders() Implement to return the available folders
java.util.Date	getLastModified() Implement to return a last modified date.
java.lang.Object	getNativeObject() Retrieves the native backend object for this database if there is any.
java.lang.String	getServerName() Returns the name of the server for the backend database (if there is one)
java.lang.String	getTitle() Retrieves a descriptive database title.
java.lang.String	getTypeName() Returns a description of this core implementation type.
ContentSourceSpecs	init(WGDatabase db, java.lang.String path) Implement to initialize the SCS implementation when the database gets opened.
boolean	insertContent(java.lang.String folder, java.lang.Object key, java.lang.Object bean) Implement functionality to insert a new data object to a folder
int	login(java.lang.String user, java.lang.String pwd) Implement to specify login behaviour for users opening single sessions.
void	logout() Called when a user session is closed to cleanup resources of it
void	removeContent(java.lang.String folder, java.lang.Object key) Implement behaviour to remove a data object from a folder
boolean	updateContent(java.lang.String folder, java.lang.Object key, java.lang.Object bean) Implement behaviour to update the database backend with new data for a data object

Methods inherited from class de.innovationgate.webgate.api.templates.SimpleContentSource

beginTransaction, beginUpdate, calculateKey, callBackendService, cleanup, clearSessionCache, close, closeSession, commitTransaction, convertFileNameForAttaching, createContent, createCopy, createDesignDocument, createStructEntry, createUserProfile, createWrapper, execProcedure, extractFolder, fastAccess, getACL, getAllContent, getAllContentKeys, getAllowedCredentialClasses, getChildEntries, getContentByKey, getContentByName, getContentCount, getContentStorePatchLevel, getContentStoreVersion, getDedicatedWorkflowEngine, getDeletions, getDesignObject, getDesignObjects, getExtensionData, getExtensionDataNames, getIncomingRelations, getParentEntry, getRevision, getRevisionDate, getRoles, getRootEntries, getSpecs, getStructEntryByKey, getStructEntryByName, getUpdatedDocumentsSince, getUpdateLogs, getUserProfile, hasFeature, isBackendServiceSupported, isContentTypeUsed, isLanguageUsed, isMemberOfUserList, moveStructEntry, open, openSession, parseStructKey, query, queryUserProfileNames, refresh, removeExtensionData, resultIsFalse, resultIsTrue, rollbackTransaction, setCurrentSession, writeExtensionData

Methods inherited from class java.lang.Object

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

Field Detail

USER_BEAN

public static final java.lang.String USER_BEAN

See Also:

Constant Field Values

COPTION_ONE_BEAN_PER

public static final java.lang.String COPTION_ONE_BEAN_PER

See Also:

Constant Field Values

COPTION_ONE_BEAN_PER_REQUEST

public static final java.lang.String COPTION_ONE_BEAN_PER_REQUEST

See Also:

Constant Field Values

COPTION_ONE_BEAN_PER_USER

public static final java.lang.String COPTION_ONE_BEAN_PER_USER

See Also:

Constant Field Values

COPTION_ONE_BEAN_PER_DB

public static final java.lang.String COPTION_ONE_BEAN_PER_DB

See Also:

Constant Field Values

COPTION_CREATION_HANDLER

public static final java.lang.String COPTION_CREATION_HANDLER

See Also:

Constant Field Values

ONE_BEAN_PER_REQUEST

public static final int ONE_BEAN_PER_REQUEST

See Also:

Constant Field Values

ONE_BEAN_PER_USER

public static final int ONE_BEAN_PER_USER

See Also:

Constant Field Values

ONE_BEAN_PER_DB

public static final int ONE_BEAN_PER_DB

See Also:

Constant Field Values

COPTION_BEAN_JARFILE

public static final java.lang.String COPTION_BEAN_JARFILE

See Also:

Constant Field Values

Constructor Detail

BeanAdapter

public BeanAdapter()

Method Detail

login

public int login(java.lang.String user,
        java.lang.String pwd)
          throws WGAPIException

Description copied from class: SimpleContentSource

Implement to specify login behaviour for users opening single sessions.

Specified by:

login in class SimpleContentSource

Parameters:

user - login username

pwd - login password

Returns:

A constant WGDatabase.ACCESSLEVEL_... to determine what access the user has on the database, WGDatabase.ACCESSLEVEL_NOTLOGGEDIN if the login should fail

Throws:

WGAPIException

logout

public void logout()

Description copied from class: SimpleContentSource

Called when a user session is closed to cleanup resources of it

Specified by:

logout in class SimpleContentSource

getTitle

public java.lang.String getTitle()

Description copied from interface: WGDatabaseCore

Retrieves a descriptive database title.

Specified by:

getTitle in interface WGDatabaseCore

Specified by:

getTitle in class SimpleContentSource

Returns:

String

getTypeName

public java.lang.String getTypeName()

Description copied from interface: WGDatabaseCore

Returns a description of this core implementation type. Normally in format "dbplatform/dbdesign/furtherInfos/..."

Specified by:

getTypeName in interface WGDatabaseCore

Specified by:

getTypeName in class SimpleContentSource

Returns:

The implementation description

getCreated

public java.util.Date getCreated()

convertToKey

public java.lang.Object convertToKey(java.lang.String key,
                            java.lang.String folder)

Description copied from class: SimpleContentSource

Converts the string representation of a data key to it's real data type.

Specified by:

convertToKey in class SimpleContentSource

Parameters:

key - The string representatino of the data key

folder - The folder of the data key

Returns:

The converted data key in it's original data type.

getContent

public java.lang.Object getContent(java.lang.String folder,
                          java.lang.Object key)

Description copied from class: SimpleContentSource

Implement to retrieve a single data object by key information. This gets called by lazy data fetching, when result maps contain only keys but no data objects.

Specified by:

getContent in class SimpleContentSource

Parameters:

folder - The folder of the object

key - The data key of the object

Returns:

The data object if there is any under this key, null otherwise

insertContent

public boolean insertContent(java.lang.String folder,
                    java.lang.Object key,
                    java.lang.Object bean)

Description copied from class: SimpleContentSource

Implement functionality to insert a new data object to a folder

Specified by:

insertContent in class SimpleContentSource

Parameters:

folder - The folder to insert this data object

key - The key for this data object. You may ignore this if this SCS implementation generates it's own keys.

bean - The data object to store

Returns:

true, if insertion succeeded, false otherwise

createContent

public java.lang.Object createContent(java.lang.String folder)

Description copied from class: SimpleContentSource

Creates a new content object in the given folder

Specified by:

createContent in class SimpleContentSource

Parameters:

folder - The folder name to create the content

Returns:

The new content object

find

public java.util.Map find(java.lang.String folder,
                 java.lang.String query,
                 java.util.Map parameters)
                   throws WGQueryException

Description copied from class: SimpleContentSource

Used to implement querying behaviour to the SCS implementation.

Specified by:

find in class SimpleContentSource

Parameters:

folder - The query type (which by default should be the folder at which the query is directed)

query - The query

parameters - Query parameters. Map keys are Constants WGDatabase.QUERYOPTION_...

Returns:

A map containing the results. Map keys should be data keys. Map values should be data objects or null to use lazy retrieval

Throws:

WGQueryException

getLastModified

public java.util.Date getLastModified()

Description copied from class: SimpleContentSource

Implement to return a last modified date. May return null if this feature is not supported by this SCS implementation.

Specified by:

getLastModified in class SimpleContentSource

removeContent

public void removeContent(java.lang.String folder,
                 java.lang.Object key)

Description copied from class: SimpleContentSource

Implement behaviour to remove a data object from a folder

Specified by:

removeContent in class SimpleContentSource

Parameters:

folder - Folder of the data object

key - Key of the data object

init

public ContentSourceSpecs init(WGDatabase db,
                      java.lang.String path)
                        throws WGInvalidDatabaseException

Description copied from class: SimpleContentSource

Implement to initialize the SCS implementation when the database gets opened.

Specified by:

init in class SimpleContentSource

Parameters:

db - The WGAPI database object, that will represent this SCS implementation

path - The database path

Returns:

Specs of this implementation, telling the template what features will get used

Throws:

WGInvalidDatabaseException

destroy

public void destroy()

Description copied from class: SimpleContentSource

Callback method, that gets called when the SCS is closed completely.

Specified by:

destroy in class SimpleContentSource

getFolders

public java.lang.String[] getFolders()

Description copied from class: SimpleContentSource

Implement to return the available folders

Specified by:

getFolders in class SimpleContentSource

Returns:

String array of folder names

browse

public java.util.Map browse(java.lang.String folder)

Description copied from class: SimpleContentSource

Browses the given folder for contents.

Specified by:

browse in class SimpleContentSource

Parameters:

folder - The folder name

Returns:

A map of data objects. Use data keys as Map keys. Use data objects as Map values or leave values null to use lazy fetching behaviour.

getServerName

public java.lang.String getServerName()

Description copied from interface: WGDatabaseCore

Returns the name of the server for the backend database (if there is one)

getDummyContent

public WGDocumentCore getDummyContent(java.lang.String language)

Description copied from interface: WGDatabaseCore

Creates a "dummy content" object, that is used, when rendering WebTML without a content context. May return the "fake" document core implementation, if no native expression language is needed.

Specified by:

getDummyContent in interface WGDatabaseCore

Overrides:

getDummyContent in class SimpleContentSource

Returns:

WGDocumentCore

getNativeObject

public java.lang.Object getNativeObject()

Description copied from interface: WGDatabaseCore

Retrieves the native backend object for this database if there is any.

Specified by:

getNativeObject in interface WGDatabaseCore

Overrides:

getNativeObject in class SimpleContentSource

updateContent

public boolean updateContent(java.lang.String folder,
                    java.lang.Object key,
                    java.lang.Object bean)

Description copied from class: SimpleContentSource

Implement behaviour to update the database backend with new data for a data object

Specified by:

updateContent in class SimpleContentSource

Parameters:

folder - The folder of the data object

key - The data key of the data object

bean - The data object itself.

Returns:

true, if update succeeded, false otherwise

getDB

public WGDatabase getDB()