com.sas.services.information
Class OMIChildServer

com.sas.services.information.OMIChildServer

All Implemented Interfaces:

com.sas.metadata.remote.MdFactoryListener, com.sas.metadata.remote.MdObjectListener, com.sas.metadata.remote.MdStoreIDChangeListener, com.sas.metadata.remote.MdStoreListener, ChildServerInterface, MetadataServerInterface, ServerInterface, java.io.Serializable, java.rmi.Remote, java.util.EventListener

public class OMIChildServer
implements ChildServerInterface

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.sas.services.information.OMIServer

OMIServer.cVetoableChangeListener, OMIServer.OMIKey

Field Summary

Fields inherited from class com.sas.services.information.OMIServer

_cache, _cnxnAdmin, _cnxnHandle, _cnxnSync, _explicitIdGrpsMap, _foundationReposName, _id2NameMap, _isDestroyed, _logger, _mdfactory, _mdstore, _name, _person, _repositories, _subNum, _typeMap, _url, BIP_COMPONENTNAME, ROOT_CLASSIDENTIFIER

Fields inherited from interface com.sas.services.information.ServerInterface

DEFAULT_SERVER_NAME, SERVER_VERSION_913_SP3, SERVER_VERSION_913_SP4, SERVER_VERSION_920, SERVER_VERSION_930, SERVER_VERSION_UNKNOWN

Constructor Summary

OMIChildServer()

OMIChildServer(com.sas.metadata.remote.MdFactory mdfactory, com.sas.metadata.remote.MdObjectStore mdstore, MetadataServerInterface parent, int childnum)

OMIChildServer(com.sas.metadata.remote.MdFactory mdfactory, com.sas.metadata.remote.MdObjectStore mdstore, MetadataServerInterface parent, int childnum, java.lang.Class theClass)

Method Summary

void	close()
void	commit() Commit the changes in this child to its parent.
void	destroy() Close the connections and release all resources in use by this server instance.
MetadataInterface	fetch(java.lang.String repositoryKey) Fetch an object from the metadat based on its URI.
MetadataInterface	fetch(java.lang.String repositoryKey, boolean bypassCache) Fetch an object from the repository given the repository key.
java.util.List	getRepositories(boolean getAll) Get a List of the requested repositories from this Server.
RepositoryInterface	getRepository(java.lang.String name) Get a named repository managed by this server.
void	rollback() Roll back the changes in this child repository by deleting the cache without flushing it to the parent.

Methods inherited from class com.sas.services.information.OMIServer

addToCache, applyACTToObj, attemptConnection, browseFetch, browseFolder, browseFolderRecursive, browseSearch, browseSearch, browseSearch, browseSearch, cachePath, clearPendingChanges, connect, connect, createAccessControTemplate, createMetadata, debug, debug, debug, deleteEntities, deleteEntity, deleteEntity, deleteInternalPassword, destroyAccessControlTemplate, error, error, executeRequest, factoryProcess, flush, flushAllCachedObjects, freeCredentials, fromByteArray, generatePassword, getAccessControlTemplateAttribs, getAccessControlTemplateList, getACTsOnObj, getApplicationActionsAuthorizations, getApplicationActionsAuthorizations, getAuthorizations, getAuthorizationsForObjects, getAuthorizationsOnObj, getCountNoSecurity, getCreateDate, getCredentials, getDomain, getEnterprisePolicies, getExplicitIdentityGroup, getFoundationRepository, getHomeFolder, getHomeFolder, getHost, getIdentitiesOnObj, getIdentity, getIdentityInfo, getInternalDomain, getInternalLoginSitePolicies, getInternalLoginUserInfo, getLoginsForAuthDomain, getMdFactory, getModifiedDate, getName, getObjectByPath, getObjectByPathFilter, getObjectStore, getPerson, getPort, getProtocol, getRepositories, getRepositoryId, getRepositoryInfo, getRepositoryInfoById, getRepositoryName, getRepositoryNames, getRootFolder, getServerVersion, getSubNum, getTypeDescriptor, getTypeDictionaryMap, getUrl, getUserContext, info, info, info, isAuthorized, isAuthorizedWithConditions, isUserAuthorized, loadExplicitIdentityGroups, loadRepositoryData, loadTypes, loadTypes, makeChainedMessage, makeKey, MdObjectModified, MdObjectsAdded, MdObjectsCreated, MdObjectsDeleted, MdObjectsModified, MdObjectsModified, MdObjectsRemoved, MdStoreIDChange, newChild, newChild, newMetadata, pulseCheck, reconnect, refreshAllData, refreshEntity, removeACTFromObj, RepositoryDeleted, search, search, search, setAccessControlTemplateAttribs, setAuthorizationsOnObj, setInternalLoginUserOptions, setInternalPassword, toByteArray, warn, warn, warn

Methods inherited from interface com.sas.services.information.ServerInterface

addToCache, browseFetch, browseFolder, browseFolderRecursive, browseSearch, browseSearch, browseSearch, browseSearch, clearPendingChanges, connect, connect, debug, debug, debug, deleteEntity, error, error, executeRequest, factoryProcess, flush, fromByteArray, generatePassword, getDomain, getExplicitIdentityGroup, getFoundationRepository, getHomeFolder, getHomeFolder, getHost, getIdentity, getName, getObjectByPath, getObjectByPathFilter, getPerson, getPort, getProtocol, getRepositories, getRepositoryInfo, getRepositoryName, getRepositoryNames, getRootFolder, getServerVersion, getTypeDescriptor, getUserContext, info, info, info, isAuthorized, isUserAuthorized, loadTypes, loadTypes, newChild, newChild, newMetadata, reconnect, refreshAllData, refreshEntity, search, search, search, toByteArray, warn, warn, warn

Constructor Detail

OMIChildServer

public OMIChildServer()
               throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

OMIChildServer

public OMIChildServer(com.sas.metadata.remote.MdFactory mdfactory,
                      com.sas.metadata.remote.MdObjectStore mdstore,
                      MetadataServerInterface parent,
                      int childnum)
               throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

OMIChildServer

public OMIChildServer(com.sas.metadata.remote.MdFactory mdfactory,
                      com.sas.metadata.remote.MdObjectStore mdstore,
                      MetadataServerInterface parent,
                      int childnum,
                      java.lang.Class theClass)
               throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

Method Detail

destroy

public void destroy()
             throws ServiceException,
                    java.rmi.RemoteException

Description copied from interface: ServerInterface

Close the connections and release all resources in use by this server instance.

Specified by:

destroy in interface ServerInterface

Overrides:

destroy in class OMIServer

Throws:

ServiceException - If a service level error occurs.

java.rmi.RemoteException - In the event of remote object failure.

commit

public void commit()
            throws ServiceException,
                   java.rmi.RemoteException

Description copied from interface: ChildServerInterface

Commit the changes in this child to its parent. If an exception is thrown during the commit, you must call rollback to close the transaction.

Specified by:

commit in interface ChildServerInterface

Throws:

ServiceException - if unable to commit the changes to the parent.

java.rmi.RemoteException - if a network anomaly is encountered.

rollback

public void rollback()
              throws ServiceException,
                     java.rmi.RemoteException

Description copied from interface: ChildServerInterface

Roll back the changes in this child repository by deleting the cache without flushing it to the parent.

Specified by:

rollback in interface ChildServerInterface

Throws:

ServiceException - if unable to rollback.

java.rmi.RemoteException - if a network anomaly is encountered.

close

public void close()
           throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getRepository

public RepositoryInterface getRepository(java.lang.String name)
                                  throws ServiceException,
                                         java.rmi.RemoteException

Description copied from interface: ServerInterface

Get a named repository managed by this server.

Specified by:

getRepository in interface ServerInterface

Overrides:

getRepository in class OMIServer

Parameters:

name - The name of the repository to return.

Returns:

A RepositoryInterface for the named repository, or null if a repository with that name wasn't found.

Throws:

ServiceException - If a server error occured.

java.rmi.RemoteException - In the event of remote object failure.

getRepositories

public java.util.List getRepositories(boolean getAll)
                               throws ServiceException,
                                      java.rmi.RemoteException

Description copied from interface: ServerInterface

Get a List of the requested repositories from this Server. This method returns a List of RepositoryInterface instances that have been explicitly requested via the ServerInterface.getRepository(String) method, unless the getAll parameter is true; then all of the repositories managed by the server are returned.

Specified by:

getRepositories in interface ServerInterface

Overrides:

getRepositories in class OMIServer

Parameters:

getAll - If true, all of the repositories managed by the server are returned. Otherwise, only the explicitly requested repositories are returned.

Returns:

A List of RepositoryInterface objects.

Throws:

ServiceException - If a service level error occurs.

java.rmi.RemoteException - In the event of remote object failure.

fetch

public MetadataInterface fetch(java.lang.String repositoryKey)
                        throws ServiceException,
                               java.rmi.RemoteException

Description copied from interface: ServerInterface

Fetch an object from the metadat based on its URI.

Specified by:

fetch in interface ServerInterface

Overrides:

fetch in class OMIServer

Parameters:

repositoryKey - When the SASDS URI is supported, this will be that String. Until then, this should be the entity key (obtained via the MetadataInterface.getEntityKey method) or the repository key (obtained via the MetadataInterface.getReposKey method);

Returns:

The metadata object that was fetched.

Throws:

ServiceException - If no object matching the URI was found, or some other error occurred.

java.rmi.RemoteException - In the event of remote object failure.

fetch

public MetadataInterface fetch(java.lang.String repositoryKey,
                               boolean bypassCache)
                        throws ServiceException,
                               java.rmi.RemoteException

Description copied from class: OMIServer

Fetch an object from the repository given the repository key. If the bypassCache flag is set then the cache will not be checked before retrieving the object from the server. If the flag is not set, then the behaviour is the same as the fetch method.

Specified by:

fetch in interface ServerInterface

Overrides:

fetch in class OMIServer

Parameters:

repositoryKey - The identifier for the object from the repository. This should be formatted as the repository ID followed by a slash, then the repository specific type. This string can be obtained using the Metadata.getReposKey method.

bypassCache - Boolean flag determines whether the cache should be checked for the object before forcing a trip to the server or not.

Returns:

The object matching the repository ID, or null.

Throws:

ServiceException - if a repository error occurs.

java.rmi.RemoteException - in the event of network errors.