com.jalios.jcms
Class BasicDataController

java.lang.Object
  com.jalios.jcms.BasicDataController

All Implemented Interfaces:

DataController, JcmsConstants, PluginComponent, JaliosConstants, Comparable

Direct Known Subclasses:

BookmarkDataController, CSRequestController, CSSlaveDataController, CSWorkspaceController, DBCommentController, DesktopDataController, ForumMemberController, ODDataController, PollController, PollVoteController, TrackerDataController, UnzipDataController, WikiPageController

public class BasicDataController
extends Object
implements DataController, JcmsConstants, PluginComponent

This class is a neutral implementation of DataController. It is intended to be used to developp custom DataController. It avoids the sub-class to implement not used methods of DataController. It implements the Comparable interface. This interface is required since JCMS 5.5.0 ; so that DataController can be invoked in a custom order. The order can be set through the constructor. Default order is 0. When 2 BasicDataControllers are equal they are ordered according their class name, then according their hashCode.

Since:

jcms-5.0.0

Version:

$Revision: 19809 $

Author:

Olivier Dedieu

Field Summary

protected int	order
static String	REVISION

Fields inherited from interface com.jalios.jcms.DataController

CTXT_DOC_DIRECTORY, CTXT_DOC_UNZIP, CTXT_DOC_UPLOAD, CTXT_FORCE_DELETE, CTXT_IGNORE_INTEGRITY_CHECK, CTXT_ORIGINAL_DATA, CTXT_REST, CTXT_WEBDAV, DO_NOT_STORE

Fields inherited from interface com.jalios.jcms.JcmsConstants

ADATE_SEARCH, ADMIN_NOTES_PROP, ADVANCED_TAB, ARCHIVES_DIR, ASCII_WIDTH, CATEGORY_TAB, CDATE_SEARCH, COMMON_ALARM, CONTENT_TAB, COOKIE_MAX_AGE, CRYPT_MD5, CRYPT_UNDEFINED, CRYPT_UNIX, CTRL_TOPIC_INTERNAL, CTRL_TOPIC_REF, CTRL_TOPIC_VALUE, CTRL_TOPIC_WRITE, CUSTOM_PROP, DAILY_MAIL_ALERT, DOCCHOOSER_HEIGHT, DOCCHOOSER_WIDTH, DOCS_DIR, EDATE_SEARCH, EMAIL_REGEXP, ERROR_MSG, FORBIDDEN_FILE_ACCESS, FORBIDDEN_REDIRECT, FORCE_REDIRECT, ICON_ARCHIVE, ICON_LOCK, ICON_LOCK_STRONG, ICON_WARN, ICON_WH_BOOK_CLOSED, ICON_WH_BOOK_OPEN, INFORMATION_MSG, JALIOS_JUNIT_PROP, JCMS_CADDY, JSYNC_DOWNLOAD_DIR, JSYNC_SYNC_ALARM, LOG_FILE, LOG_TOPIC_SECURITY, LOGGER_PROP, LOGGER_XMLPROP, MBR_PHOTO_DIR, MDATE_SEARCH, MONITOR_XML, MONTHLY_MAIL_ALERT, NO_MAIL_ALERT, OP_CREATE, OP_DEEP_COPY, OP_DEEP_DELETE, OP_DELETE, OP_MERGE, OP_UPDATE, PDATE_SEARCH, PHOTO_LARGE_HEIGHT, PHOTO_LARGE_WIDTH, PHOTO_SMALL_HEIGHT, PHOTO_SMALL_WIDTH, PHOTO_TINY_HEIGHT, PHOTO_TINY_WIDTH, PREVIOUS_TAB, PRINT_VIEW, PRIVATE_FILE_ACCESS, PUBLIC_FILE_ACCESS, READ_RIGHT_TAB, SDATE_SEARCH, SEARCHENGINE_ALARM, STATS_REPORT_DIR, STATUS_PROP, STORE_XML, TEMPLATE_TAB, THUMBNAIL_LARGE_HEIGHT, THUMBNAIL_LARGE_WIDTH, THUMBNAIL_SMALL_HEIGHT, THUMBNAIL_SMALL_WIDTH, UDATE_SEARCH, UPDATE_RIGHT_TAB, UPLOAD_DIR, URL_REGEXP, WARNING_MSG, WEBAPP_PROP, WEEKLY_MAIL_ALERT, WFEXPRESS_ALARM, WFREMINDER_ALARM, WORKFLOW_TAB, WORKFLOW_XML

Fields inherited from interface com.jalios.util.JaliosConstants

CRLF, MILLIS_IN_ONE_DAY, MILLIS_IN_ONE_HOUR, MILLIS_IN_ONE_MINUTE, MILLIS_IN_ONE_MONTH, MILLIS_IN_ONE_SECOND, MILLIS_IN_ONE_WEEK, MILLIS_IN_ONE_YEAR

Constructor Summary

BasicDataController()
Constructs a BasicDataController with order = 0

BasicDataController(int order)
Constructs a BasicDataController with the given order

Method Summary

void	afterWrite(Data data, int op, Member mbr, Map context) This method is called once the write operation has been performed.
void	beforeWrite(Data data, int op, Member mbr, Map context) This method is called before the write operation is performed.
ControllerStatus	checkIntegrity(Data data) Checks if the given data respects constraints integrity
ControllerStatus	checkWrite(Data data, int op, Member mbr, boolean checkIntegrity, Map context) Checks if the given write operation can be performed
int	compareTo(Object obj) Compare this object with the specified object for order.
boolean	equals(Object obj) Indicates wheter some other object is "equal to" this one.
boolean	init(Plugin plugin) Initialize the component with the given plugin configuration

Methods inherited from class java.lang.Object

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

Field Detail

REVISION

public static final String REVISION

See Also:

Constant Field Values

order

protected int order

Constructor Detail

BasicDataController

public BasicDataController()

Constructs a BasicDataController with order = 0

Since:

jcms-5.0.0

BasicDataController

public BasicDataController(int order)

Constructs a BasicDataController with the given order

Parameters:

order - the order

Since:

jcms-5.5.0

Method Detail

init

public boolean init(Plugin plugin)

Description copied from interface: PluginComponent

Initialize the component with the given plugin configuration

Specified by:

init in interface PluginComponent

Parameters:

plugin - the calling plugin

Returns:

true if the conponent has been correctly initialized.

Since:

jcms-5.7.1

See Also:

PluginComponent.init(Plugin)

checkIntegrity

public ControllerStatus checkIntegrity(Data data)

Checks if the given data respects constraints integrity

Specified by:

checkIntegrity in interface DataController

Parameters:

data - the data to be checked

Returns:

a ControllerStatus

Since:

jcms-5.0.0

checkWrite

public ControllerStatus checkWrite(Data data,
                                   int op,
                                   Member mbr,
                                   boolean checkIntegrity,
                                   Map context)

Checks if the given write operation can be performed

Specified by:

checkWrite in interface DataController

Parameters:

data - the data involved by this operation

op - the operation (OP_CREATE, OP_UPDATE, ...)

mbr - the member which requests the write operation

checkIntegrity - if true, requires the constraints integrity to be checked

context - a map which contains context parameters (may be null)

Returns:

a ControllerStatus

Since:

jcms-5.0.0

beforeWrite

public void beforeWrite(Data data,
                        int op,
                        Member mbr,
                        Map context)

This method is called before the write operation is performed.

Specified by:

beforeWrite in interface DataController

Parameters:

data - the data which will be written

op - the operation (OP_CREATE, OP_UPDATE, ...)

mbr - the member which requests the write operation

context - a map which contains context parameters (may be null)

Since:

jcms-5.0.0

afterWrite

public void afterWrite(Data data,
                       int op,
                       Member mbr,
                       Map context)

This method is called once the write operation has been performed.

Specified by:

afterWrite in interface DataController

Parameters:

data - the data which will be written

op - the operation (OP_CREATE, OP_UPDATE, ...)

mbr - the member which requests the write operation

context - a map which contains context parameters (may be null)

Since:

jcms-5.0.0

compareTo

public int compareTo(Object obj)

Compare this object with the specified object for order.

Specified by:

compareTo in interface Comparable

Parameters:

obj - the Object to be compared.

See Also:

Comparable.compareTo(java.lang.Object)

equals

public boolean equals(Object obj)

Indicates wheter some other object is "equal to" this one. The comparison is performed with compareTo() method.

Overrides:

equals in class Object

Parameters:

obj - the Object to be compared.