org.apache.jetspeed.serializer
Interface JetspeedSerializer

public interface JetspeedSerializer

Jetspeed Serializer

The Serializer is capable of reading and writing the current content of the Jetspeed environment to and from XML files. The component can be used from a standalone java application for seeding a new database or from a running portal as an administrative backup/restore function.

The XML file needs to indicate whether passwords used in credentials are plain text or whether they are encoded. The import algoritm can determine - prior to reading users - which encode/decode scheme was used and if or then we store plain passwords (Note that that alone requires the resulting XML to be encoded!!!!!)

Version:

$Id: JetspeedSerializer.java 0 2006-10-31 22:51:28Z hjb $

Author:

Hajo Birthelmer

Field Summary

static short	DECODING_SUPPORTED the passwords are encoded and the provider is the same as the data source and we have a 2-way algorithm
static java.lang.String	DEFAULT_TAG_SNAPSHOT_NAME the main tag in the XML file
static short	ERROR_DECODING Error in determening correct password handling
static short	INVALID_PASSWORDS the passwords are encoded and the current provider is DIFFERENT....
static java.lang.String	KEY_BACKUP_BEFORE_PROCESS
static java.lang.String	KEY_EXPORT_INDENTATION
static java.lang.String	KEY_LOGGER
static java.lang.String	KEY_OVERWRITE_EXISTING
static java.lang.String	KEY_PROCESS_CAPABILITIES
static java.lang.String	KEY_PROCESS_PERMISSIONS
static java.lang.String	KEY_PROCESS_PORTAL_PREFERENCES
static java.lang.String	KEY_PROCESS_PROFILER
static java.lang.String	KEY_PROCESS_SSO
static java.lang.String	KEY_PROCESS_USER_PREFERENCES
static java.lang.String	KEY_PROCESS_USER_TEMPLATES
static java.lang.String	KEY_PROCESS_USERS export/import instructions
static short	NO_DECODING the passwords are in clear text
static short	PASSTHRU_REQUIRED the passwords are encoded and the provider is the same as the data source, but is a 1-way algorithm
static java.lang.String[]	TAG_SNAPSHOT_NAMES

Method Summary

void	deleteData()
void	deleteData(java.util.Map settings)
void	exportData(java.lang.String name, java.lang.String exportFileName) Main routine to export the set of data elements and write them to the named XML file.
void	exportData(java.lang.String name, java.lang.String exportFileName, java.util.Map settings) Main routine to export the set of data elements and write them to the named XML file.
java.util.Map	getDefaultSettings()
java.util.List	getSerializers()
void	importData(java.lang.String importFileName) Main routine to import the set of data elements and write them to the current environment.
void	importData(java.lang.String importFileName, java.util.Map settings) Main routine to import the set of data elements and write them to the current environment.

Field Detail

ERROR_DECODING

static final short ERROR_DECODING

Error in determening correct password handling

See Also:

Constant Field Values

NO_DECODING

static final short NO_DECODING

the passwords are in clear text

See Also:

Constant Field Values

PASSTHRU_REQUIRED

static final short PASSTHRU_REQUIRED

the passwords are encoded and the provider is the same as the data source, but is a 1-way algorithm

See Also:

Constant Field Values

DECODING_SUPPORTED

static final short DECODING_SUPPORTED

the passwords are encoded and the provider is the same as the data source and we have a 2-way algorithm

See Also:

Constant Field Values

INVALID_PASSWORDS

static final short INVALID_PASSWORDS

the passwords are encoded and the current provider is DIFFERENT....

See Also:

Constant Field Values

KEY_PROCESS_USERS

static final java.lang.String KEY_PROCESS_USERS

export/import instructions

See Also:

Constant Field Values

KEY_PROCESS_CAPABILITIES

static final java.lang.String KEY_PROCESS_CAPABILITIES

See Also:

Constant Field Values

KEY_PROCESS_PROFILER

static final java.lang.String KEY_PROCESS_PROFILER

See Also:

Constant Field Values

KEY_PROCESS_PERMISSIONS

static final java.lang.String KEY_PROCESS_PERMISSIONS

See Also:

Constant Field Values

KEY_PROCESS_USER_PREFERENCES

static final java.lang.String KEY_PROCESS_USER_PREFERENCES

See Also:

Constant Field Values

KEY_PROCESS_PORTAL_PREFERENCES

static final java.lang.String KEY_PROCESS_PORTAL_PREFERENCES

See Also:

Constant Field Values

KEY_PROCESS_USER_TEMPLATES

static final java.lang.String KEY_PROCESS_USER_TEMPLATES

See Also:

Constant Field Values

KEY_PROCESS_SSO

static final java.lang.String KEY_PROCESS_SSO

See Also:

Constant Field Values

KEY_LOGGER

static final java.lang.String KEY_LOGGER

See Also:

Constant Field Values

KEY_OVERWRITE_EXISTING

static final java.lang.String KEY_OVERWRITE_EXISTING

See Also:

Constant Field Values

KEY_BACKUP_BEFORE_PROCESS

static final java.lang.String KEY_BACKUP_BEFORE_PROCESS

See Also:

Constant Field Values

KEY_EXPORT_INDENTATION

static final java.lang.String KEY_EXPORT_INDENTATION

See Also:

Constant Field Values

DEFAULT_TAG_SNAPSHOT_NAME

static final java.lang.String DEFAULT_TAG_SNAPSHOT_NAME

the main tag in the XML file

See Also:

Constant Field Values

TAG_SNAPSHOT_NAMES

static final java.lang.String[] TAG_SNAPSHOT_NAMES

Method Detail

getSerializers

java.util.List getSerializers()

getDefaultSettings

java.util.Map getDefaultSettings()

exportData

void exportData(java.lang.String name,
                java.lang.String exportFileName)
                throws SerializerException

Main routine to export the set of data elements and write them to the named XML file.

Parameters:

name - of the snapshot

exportFileName -

Throws:

SerializerException

exportData

void exportData(java.lang.String name,
                java.lang.String exportFileName,
                java.util.Map settings)
                throws SerializerException

Main routine to export the set of data elements and write them to the named XML file. The default behavior of the serializer is that all available data is extracted and the target file gets created or overwritten

The caller can adjust the default behavior by passign in a map of flags. Each map entry is keyed by a key Constant and the associated Boolean value, for exammple KEY_PROCESS_USER_PREFERENCES, Boolean.FALSE would cause the serializer to skip user preferences.

Note that ProfilingRules require the users . Hence turning off User collection will automatically turn off the Profiling rules

Parameters:

name - of the snapshot

exportFileName -

settings - optional Map overwriting default export behavior

Throws:

SerializerException

importData

void importData(java.lang.String importFileName)
                throws SerializerException

Main routine to import the set of data elements and write them to the current environment.

Parameters:

importFileName -

settings - optional Map overwriting default import behavior

Throws:

SerializerException

importData

void importData(java.lang.String importFileName,
                java.util.Map settings)
                throws SerializerException

Main routine to import the set of data elements and write them to the current environment.

Existing entries (like users) etc. will be overwritten with the provided data.

The caller can adjust the default behavior by passign in a map of flags. Each map entry is keyed by a key Constant and the associated Boolean value, for exammple KEY_PROCESS_USER_PREFERENCES, Boolean.FALSE would cause the serializer to skip user preferences.

Note that settings are valid throughout each invocation. Therefore if a caller wants to preserve current users and only add new entries while at the same time overwrite all profiling rules, exportData has to be invoked twice - once to process only the users with the no-overwrite option and once to process the profiling rules

Parameters:

importFileName -

settings - optional Map overwriting default import behavior

Throws:

SerializerException

deleteData

void deleteData()
                throws SerializerException

Throws:

SerializerException

deleteData

void deleteData(java.util.Map settings)
                throws SerializerException

Throws:

SerializerException