[teiid-commits] teiid SVN: r1478 - in trunk/common-internal/src/main/java/com/metamatrix: core and 7 other directories.

Author: shawkins Date: 2009-09-24 10:40:50 -0400 (Thu, 24 Sep 2009) New Revision: 1478 Removed: trunk/common-internal/src/main/java/com/metamatrix/api/exception/server/ trunk/common-internal/src/main/java/com/metamatrix/core/event/ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/AuthorizationAdminAPI.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ConfigurationAdminAPI.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ExtensionSourceAdminAPI.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateAdminAPI.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateChangeEvent.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/SubSystemAdminAPI.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/ProductNotRegisteredException.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/UnknownProductOrSubsystemException.java trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/runtime/ trunk/common-internal/src/main/java/com/metamatrix/platform/service/api/ trunk/common-internal/src/main/java/com/metamatrix/platform/vm/controller/ProcessStatistics.java trunk/common-internal/src/main/java/com/metamatrix/server/admin/api/RuntimeMetadataAdminAPI.java trunk/common-internal/src/main/java/com/metamatrix/vdb/edit/loader/ Modified: trunk/common-internal/src/main/java/com/metamatrix/metadata/runtime/api/VirtualDatabaseException.java Log: TEIID-854 removing server related code Modified: trunk/common-internal/src/main/java/com/metamatrix/metadata/runtime/api/VirtualDatabaseException.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/metadata/runtime/api/VirtualDatabaseException.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/metadata/runtime/api/VirtualDatabaseException.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -22,11 +22,11 @@ package com.metamatrix.metadata.runtime.api; -import com.metamatrix.vdb.edit.loader.VdbProcessingException; +import com.metamatrix.api.exception.MetaMatrixProcessingException; /** * The base exception from which all Runtime Metadata Exceptions extend. */ -public class VirtualDatabaseException extends VdbProcessingException { +public class VirtualDatabaseException extends MetaMatrixProcessingException { public static final String NO_MODELS = "1"; //$NON-NLS-1$ public static final String MODEL_NON_DEPLOYABLE_STATE = "2"; //$NON-NLS-1$ Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/AuthorizationAdminAPI.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/AuthorizationAdminAPI.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/AuthorizationAdminAPI.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,191 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api; - -import java.util.Collection; -import java.util.List; -import java.util.Map; -import java.util.Set; - -import com.metamatrix.admin.api.exception.security.InvalidSessionException; -import com.metamatrix.api.exception.MetaMatrixComponentException; -import com.metamatrix.api.exception.security.AuthorizationException; -import com.metamatrix.api.exception.security.AuthorizationMgmtException; -import com.metamatrix.api.exception.security.MembershipServiceException; -import com.metamatrix.platform.security.api.AuthorizationPolicy; -import com.metamatrix.platform.security.api.AuthorizationPolicyID; -import com.metamatrix.platform.security.api.AuthorizationRealm; -import com.metamatrix.platform.security.api.MetaMatrixPrincipalName; - -public interface AuthorizationAdminAPI extends SubSystemAdminAPI { - - /** - * Returns a <code>AuthorizationObjectEditor</code> to perform editing operations - * on a entitlement type object. The editing process will create actions for - * each specific type of editing operation. Those actions are what need to be - * submitted to the <code>AuthorizationService</code> for actual updates to occur. - * @return AuthorizationObjectEditor - */ - AuthorizationEditor createEditor() - throws InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Obtain the names of all of the roles and their descriptions known to the system. - * @return a Map of role descriptions key by the role's name. - * @throws InvalidSessionException if the <code>SessionToken</code> is not valid or is expired - * @throws AuthorizationException if the caller is unable to perform this operation - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Map getRoleDescriptions() - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Returns a collection <code>MetaMatrixPrincipalName</code> objects containing the name - * of the principal along with its type which belong to the given role. - * {@link com.metamatrix.security.api.MetaMatrixPrincipalName} - * @param roleName String name of MetaMatrix role for which principals - * are sought - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Collection getPrincipalsForRole(String roleName) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Returns a Collection of String names of MetaMatrix roles to which the - * given principal is assigned. - * @param principal <code>MetaMatrixPrincipalName</code> for which roles are sought - * @param explicitOnly If true, only return roles assigned directly to given principal. - * If false, return all roles directly assigned and inherited. - * @return The <code>Collection</code> of role names the principal is assigned. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Collection getRoleNamesForPrincipal(MetaMatrixPrincipalName principal) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Add the given set of principals to the given role. - * @param principals Set of <code>MetaMatrixPrincipalName</code>s to which to add. - * @param roleName The name of the role to which to add the principals. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - void addPrincipalsToRole(Set principals, String roleName) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Returns true if the given username matches the current membership security.membership.admin.username - * from the current config - * @param username the username to compare to the current super user - * @return - * @throws ServiceException for generic service errors - * @throws MembershipServiceException If there are issues within the membership service - * @throws MetaMatrixComponentException if this service has trouble communicating. - * - */ - boolean isSuperUser(String username) throws MembershipServiceException, MetaMatrixComponentException; - - - /** - * Remove the given set of principals from the given role. - * @param principals Set of <code>MetaMatrixPrincipalName</code>s to remove. - * @param roleName The name of the role from which to remove the principals. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - void removePrincipalsFromRole(Set principals, String roleName) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Locate the IDs of all of the policies that are accessible by the caller. - * @param caller the session token of the principal that is attempting to access the policies. - * @return the set of all policy IDs - * @throws InvalidSessionException if the <code>SessionToken</code> is not valid or is expired - * @throws AuthorizationException if the caller is unable to perform this operation - * @throws AuthorizationMgmtException if this service has trouble connecting to services it uses. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Collection findAllPolicyIDs() - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Return whether there is an existing policy with the specified ID. - * @param id the ID that is to be checked - * @return true if a policy with the specified ID exists - * @throws InvalidSessionException if the <code>SessionToken</code> is not valid or is expired - * @throws AuthorizationException if the caller is unable to perform this operation - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Boolean containsPolicy(AuthorizationPolicyID policyID) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Locate the policy that has the specified ID. Any ID that is invalid is simply - * ignored. - * @param policyID the ID of the policy to be obtained - * @return the policy that correspond to the specified ID - * @throws InvalidSessionException if the <code>SessionToken</code> is not valid or is expired - * @throws AuthorizationException if the caller is unable to perform this operation - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - AuthorizationPolicy getPolicy(AuthorizationPolicyID policyID) - throws AuthorizationException, AuthorizationMgmtException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Execute as a single transaction with the specified actions, and return - * the set of IDs for the objects that were affected/modified by the action. - * @param actions the ordered list of actions that are to be performed - * on metamodel within the repository. - * @return The set of objects that were affected by this transaction. - * @throws InvalidSessionException if the <code>SessionToken</code> is not valid or has expired. - * @throws AuthorizationException if the caller is unable to perform this operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Set executeTransaction(List actions) - throws AuthorizationException, AuthorizationMgmtException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Returns a <code>Collection</code> of <code>AuthorizationPolicyID</code>s - * in the given <code>AuthorizationRealm</code>. - * <br>This method will only work for Data Access Authorizations because the realm - * is encoded in a Data Access policy name. - * <strong>NOTE:</strong> It is the responsibility of the caller to determine - * which of the <code>AuthorizationPolicy</code>'s <code>AuthorizationPermission</code>s - * are actually in the given <code>AuthorizationRealm</code>. The <code>AuthorizationPolicy</code> - * may span <code>AuthorizationRealm</code>s. - * @param realm The realm in which to search for <code>AuthorizationPermission</code>s. - * @return The collection of <code>AuthorizationPolicyID</code>s that have permissions - * in the given realm - possibly empty but never null. - * @throws AuthorizationException if admninistrator does not have the authority to preform the action. - * @throws AuthorizationMgmtException if an error occurs in the Authorization store. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - Collection getPolicyIDsInRealm(AuthorizationRealm realm) - throws AuthorizationException, AuthorizationMgmtException, InvalidSessionException, MetaMatrixComponentException; -} - Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ConfigurationAdminAPI.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ConfigurationAdminAPI.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ConfigurationAdminAPI.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,300 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api; - -import java.util.Collection; -import java.util.List; -import java.util.Set; - -import com.metamatrix.admin.api.exception.security.InvalidSessionException; -import com.metamatrix.api.exception.MetaMatrixComponentException; -import com.metamatrix.api.exception.security.AuthorizationException; -import com.metamatrix.common.actions.ActionDefinition; -import com.metamatrix.common.actions.ModificationException; -import com.metamatrix.common.config.api.ComponentDefn; -import com.metamatrix.common.config.api.ComponentDefnID; -import com.metamatrix.common.config.api.ComponentType; -import com.metamatrix.common.config.api.ComponentTypeID; -import com.metamatrix.common.config.api.Configuration; -import com.metamatrix.common.config.api.ConfigurationID; -import com.metamatrix.common.config.api.ConfigurationModelContainer; -import com.metamatrix.common.config.api.ConfigurationObjectEditor; -import com.metamatrix.common.config.api.Host; -import com.metamatrix.common.config.api.HostID; -import com.metamatrix.common.config.api.exceptions.ConfigurationException; - - -public interface ConfigurationAdminAPI extends SubSystemAdminAPI { - - /** - * Returns a <code>ConfigurationObjectEditor</code> to perform editing operations - * on a configuration type object. The editing process will create actions for - * each specific type of editing operation. Those actions are what need to be - * submitted to the <code>ConfigurationService</code> for actual updates to occur. - * @return ConfigurationObjectEditor - */ - ConfigurationObjectEditor createEditor() - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns the ID of the next startup <code>Configuration</code>, which should reflect - * the desired runtime state of the system. - * @return ID of next startup configuration - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws MetaMatrixComponentException if a general remote system problem occurred - */ - ConfigurationID getNextStartupConfigurationID() - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns the current deployed <code>Configuration</code>. Note, this configuration - * may not match the actual configuration the system is currently executing under due - * to administrative task that can be done to tune the system. Those administrative - * task <b>do not</b> change the actual <code>Configuration</code> stored in the - * <code>ConfigurationService</code>. - * @return Configuration that is currently in use - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - */ - Configuration getCurrentConfiguration() - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns the current deployed <code>Configuration</code>. Note, this configuration - * may not match the actual configuration the system is currently executing under due - * to administrative task that can be done to tune the system. Those administrative - * task <b>do not</b> change the actual <code>Configuration</code> stored in the - * <code>ConfigurationService</code>. - * @return Configuration that is currently in use - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - */ - Configuration getNextStartupConfiguration() - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns the current <code>ConfigurationModelContainer</code>. Note, this configuration - * may not match the actual configuration the system is currently executing under due - * to administrative task that can be done to tune the system. Those administrative - * task <b>do not</b> change the actual <code>Configuration</code> stored in the - * <code>ConfigurationService</code>. - * @param configName is the name of the Configuration model to obtain - * @return Configuration that is currently in use - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - */ - ConfigurationModelContainer getConfigurationModel(String configName) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - - - /** - * <p>Returns a Collection containing the Configuration object for the specified - * ConfigurationID id, and also any dependant objects needed to fully - * define this configuration, such as Host objects, ComponentType - * objects, and ComponentTypeDefn objects.</p> - * - * <p>A Configuration instance contains all of the - * <code>ComponentDefn</code> objects that "belong" to just that - * Configuration: VM component definitions, service - * component definitions, product service configurations, and - * deployed components. Objects such as Host objects, - * ComponentType objects, and ComponentTypeDefn objects describe - * ComponentDefns, but are not contained by a Configuration. Therefore, - * they are included in this Collection for convenience.</p> - * - * <p>The Collection will contain instances of - * {@link com.metamatrix.common.namedobject.BaseObject}. - * Specifically, this Map should contain the objects for: - * one configuration object, one or more Host objects, one or more - * ComponentType objects, and one or more ComponentTypeDefn objects.</p> - * - * <p>This method is intended to facilitate exporting a configuration - * to XML.</p> - * - * <p>Here is what the Collection would contain at runtime: - * <pre> - * Configuration instance - * Host instance1 - * Host instance2 - * ... - * ComponentType instance1 - * ComponentType instance2 - * ... - * ComponentTypeDefn instance1 - * ComponentTypeDefn instance2 - * </pre></p> - * - * @param configID ID Of a Configuration - * @return Collection of BaseObject instances - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws MetaMatrixComponentException if a general remote system problem occurred - */ - Collection getConfigurationAndDependents(ConfigurationID configID) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns the component type definitions for the specified <code>ComponentTypeID</code>. - * This does not return the dependent definitions for service type components. - * @param componentTypeID is a ComponentTypeID - * @return Collection of ComponentTypeDefns - * - * @see getDependentComponentTypeDefinitions(ComponentTypeID) - */ - Collection getComponentTypeDefinitions(ComponentTypeID componentTypeID) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - - /** - * Returns the all component type definitions for the specified <code>ComponentTypeID</code>. - * This includes the dependent definitions for service type components. - * @param componentTypeID is a ComponentTypeID - * @return Collection of ComponentTypeDefns - * - * @see getDependentComponentTypeDefinitions(ComponentTypeID) - */ - Collection getAllComponentTypeDefinitions(ComponentTypeID componentTypeID) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns a <code>ComponentType</code> for the specified <code>ComponentTypeID</code> - * @param id is for the requested component type. - * @return ComponentType based on the id - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - */ - ComponentType getComponentType(ComponentTypeID id) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns a <code>List</code> of type <code>ComponentType</code> that represents - * all the ComponentTypes defined. Note that this will include objects of - * type ProductType (a subclass of ComponentType). - * @param includeDeprecated true if class names that have been deprecated should be - * included in the returned list, or false if only non-deprecated constants should be returned. - * @return Collection of type <code>ComponentType</code> - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - * @see ComponentType - * @see #getAllProductTypes - */ - Collection getAllComponentTypes(boolean includeDeprecated) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns a <code>Host</code> for the specified <code>HostID</code>. - * </br> - * @return Host - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - */ - Host getHost(HostID hostID) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns a Collection of {@link com.metamatrix.common.config.api.ResourceDescriptor ResourceDescriptor} - * for all internal resources defined to the system. The internal resources are not managed with - * the other configuration related information. They are not dictated based on which configuration - * they will operate (i.e., next startup or operational); - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException if an error occurred in communicating with a component. - */ - Collection getResources() - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Save the resource changes based on each {@link com.metamatrix.common.config.api.ResourceDescriptor ResourceDescriptor} - * in the collection. - * @param resourceDescriptors for the resources to be changed * - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException if an error occurred in communicating with a component. - */ - void saveResources(Collection resourceDescriptors) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - - - - /** - * Returns a <code>ComponentDefn</code> for the specified <code>ComponentDefnID</code>. - * </br> - * @return ComponentDefn - * @throws ConfigurationException if an error occurred within or during communication with the Configuration Service. - */ - ComponentDefn getComponentDefn(ConfigurationID configurationID, ComponentDefnID componentDefnID) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - - - // -------------------------------------------------------------- - // A C T I O N M E T H O D S - // -------------------------------------------------------------- - - /** - * Execute as a single transaction the specified action, and optionally - * return the set of objects or object IDs that were affected/modified by the action. - * @param action the definition of the action to be performed on data within - * the repository. - * @return the set of objects that were affected by this transaction. - * @throws ModificationException if the target of the action is invalid, or - * if the target object is not a supported class of targets. - * @throws IllegalArgumentException if the action is null - * or if the result specification is invalid - * @throws ConfigurationException if an error occurred within or during - * communication with the Metadata Service. - */ - Set executeTransaction(ActionDefinition action) - throws ModificationException, ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Execute a list of actions, and optionally - * return the set of objects or object IDs that were affected/modified by the action. - * @param actions the ordered list of actions that are to be performed on data within - * the repository. - * @return the set of objects that were affected by this transaction. - * @throws ModificationException if the target of any of the actions is invalid, or - * if the target object is not a supported class of targets. - * @throws IllegalArgumentException if the action is null - * or if the result specification is invalid - * @throws ConfigurationException if an error occurred within or during - * communication with the Metadata Service. - */ - Set executeTransaction(List actions) - throws ModificationException, ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Check whether the encrypted properties for the specified ComponentDefns can be decrypted. - * @param defns List<ComponentDefn> - * @return List<Boolean> in the same order as the paramater <code>defns</code>. - * For each, true if the properties could be decrypted for that defn. - * @throws ConfigurationException - * @throws InvalidSessionException - * @throws AuthorizationException - * @throws MetaMatrixComponentException - * @since 4.3 - */ - List checkPropertiesDecryptable(List defns) - throws ConfigurationException, InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - -} - Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ExtensionSourceAdminAPI.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ExtensionSourceAdminAPI.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/ExtensionSourceAdminAPI.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,243 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api; - -import java.util.Collection; -import java.util.List; - -import com.metamatrix.admin.api.exception.security.InvalidSessionException; -import com.metamatrix.api.exception.MetaMatrixComponentException; -import com.metamatrix.api.exception.security.AuthorizationException; -import com.metamatrix.common.extensionmodule.ExtensionModuleDescriptor; -import com.metamatrix.common.extensionmodule.exception.DuplicateExtensionModuleException; -import com.metamatrix.common.extensionmodule.exception.ExtensionModuleNotFoundException; -import com.metamatrix.common.extensionmodule.exception.ExtensionModuleOrderingException; -import com.metamatrix.common.extensionmodule.exception.InvalidExtensionModuleTypeException; - - -/** - * Administrative subsystem API for managing extension sources: JAR files and - * other assorted XML files centrally accessible via the Platform. - */ -public interface ExtensionSourceAdminAPI extends SubSystemAdminAPI { - - /** - * The limit to the number of characters an extension source name - * can be. - */ - public static final int SOURCE_NAME_LENGTH_LIMIT = 255; - - /** - * The limit to the number of characters an extension source description - * can be. - */ - public static final int SOURCE_DESCRIPTION_LENGTH_LIMIT = 255; - - - /** - * Adds an extension source to the end of the list of sources - * @param type one of the known types of extension file - * @param sourceName name (e.g. filename) of extension source - * @param source actual contents of source - * @param description (optional) description of the extension source - * @param enabled indicates whether each extension source is enabled for - * being searched or not (for convenience, a source can be disabled - * without being removed) - * @return ExtensionSourceDescriptor describing the newly-added - * extension source - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws DuplicateExtensionSourceException if an extension source - * with the same sourceName already exists - * @throws InvalidExtensionTypeException if the indicated type is not one - * of the currently-supported extension source types - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - ExtensionModuleDescriptor addSource(String type, String sourceName, byte[] source, String description, boolean enabled) - throws InvalidSessionException, AuthorizationException, DuplicateExtensionModuleException, InvalidExtensionModuleTypeException, MetaMatrixComponentException; - - /** - * Deletes a source from the list of sources - * @param sourceName name (e.g. filename) of extension source - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws ExtensionSourceNotFoundException if no extension source with - * name sourceName can be found - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - void removeSource(String sourceName) - throws InvalidSessionException, AuthorizationException, ExtensionModuleNotFoundException, MetaMatrixComponentException; - - /** - * Returns List (of Strings) of all extension source types currently - * supported. - * @return List of the String names of the currently-supported extension - * source types - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - Collection getSourceTypes() - throws InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns List (of Strings) of all extension source names, in order of - * their search ordering - * @return List (of Strings) of all extension source names, in order of - * their search ordering - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - List getSourceNames() - throws InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns List of ExtensionSourceDescriptor objects, in order - * of their search ordering - * @return List of ExtensionSourceDescriptor objects, in order - * of their search ordering - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - List getSourceDescriptors() - throws InvalidSessionException, AuthorizationException, MetaMatrixComponentException; - - /** - * Returns the ExtensionSourceDescriptor object for the extension - * source indicated by sourceName - * @param sourceName name (e.g. filename) of extension source - * @return the ExtensionSourceDescriptor object for the extension - * source indicated by sourceName - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws ExtensionSourceNotFoundException if no extension source with - * name sourceName can be found - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - ExtensionModuleDescriptor getSourceDescriptor(String sourceName) - throws InvalidSessionException, AuthorizationException, ExtensionModuleNotFoundException, MetaMatrixComponentException; - - /** - * Sets the positions in the search order of all sources (all sources - * must be included or an ExtensionSourceOrderingException will be thrown) - * The sourceNames List parameter should indicate the new desired order. - * @param sourceNames Collection of String names of existing - * extension sources whose search position is to be set - * @return updated List of ExtensionSourceDescriptor objects, in order - * of their search ordering - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws ExtensionSourceOrderingException if the extension files could - * not be ordered as requested because another administrator had - * concurrently added or removed an extension file or files, or because - * an indicated position is out of bounds. - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - List setSearchOrder(List sourceNames) - throws InvalidSessionException, AuthorizationException, ExtensionModuleOrderingException, MetaMatrixComponentException; - - /** - * Sets the "enabled" (for searching) property of all of the indicated - * extension sources. - * @param sourceNames Collection of String names of existing - * extension sources whose "enabled" status is to be set - * @param enabled indicates whether each extension source is enabled for - * being searched or not (for convenience, a source can be disabled - * without being removed) - * @return updated List of ExtensionSourceDescriptor objects, in order - * of their search ordering - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws ExtensionSourceNotFoundException if no extension source with - * name sourceName can be found - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - List setEnabled(Collection sourceNames, boolean enabled) - throws InvalidSessionException, AuthorizationException, ExtensionModuleNotFoundException, MetaMatrixComponentException; - - /** - * Updates the indicated extension source - * @param sourceName name (e.g. filename) of extension source - * @param source actual contents of source - * @return ExtensionSourceDescriptor describing the newly-updated - * extension source - * @throws InvalidSessionException if there is not a valid administrative session - * @throws AuthorizationException if the administrator does not have privileges to use this method - * @throws ExtensionSourceNotFoundException if no extension source with - * name sourceName can be found - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - ExtensionModuleDescriptor setSource(String sourceName, byte[] source) - throws InvalidSessionException, AuthorizationException, ExtensionModuleNotFoundException, MetaMatrixComponentException; - - /** - * Updates the indicated extension source's source name - * @param sourceName name (e.g. filename) of extension source - * @param newName new name for the source - * @return ExtensionSourceDescriptor describing the newly-updated - * extension source - * @throws ExtensionSourceNotFoundException if no extension source with - * name sourceName can be found - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - ExtensionModuleDescriptor setSourceName(String sourceName, String newName) - throws InvalidSessionException, AuthorizationException, ExtensionModuleNotFoundException, MetaMatrixComponentException; - - /** - * Updates the indicated extension source's description - * @param sourceName name (e.g. filename) of extension source - * @param description (optional) description of the extension source. - * <code>null</code> can be passed in to indicate no description. - * @return ExtensionSourceDescriptor describing the newly-updated - * extension source - * @throws ExtensionSourceNotFoundException if no extension source with - * name sourceName can be found - * @throws MetaMatrixComponentException indicating a non-business-related - * exception (such as a communication exception) - */ - ExtensionModuleDescriptor setSourceDescription(String sourceName, String description) - throws InvalidSessionException, AuthorizationException, ExtensionModuleNotFoundException, MetaMatrixComponentException; - - /** - * Checks if the extension module exists. - * @param sourceName name (e.g. filename) of extension source - * @return Returns true if the Extension module exists. false otherwise. - * @throws InvalidSessionException - * @throws AuthorizationException - * @throws MetaMatrixComponentException - */ - boolean isSourceExists(String sourceName) throws InvalidSessionException, AuthorizationException, MetaMatrixComponentException; -} - Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateAdminAPI.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateAdminAPI.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateAdminAPI.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,468 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api; - -import java.util.Collection; -import java.util.Date; -import java.util.List; - -import com.metamatrix.admin.api.exception.security.InvalidSessionException; -import com.metamatrix.api.exception.MetaMatrixComponentException; -import com.metamatrix.api.exception.MultipleException; -import com.metamatrix.api.exception.security.AuthorizationException; -import com.metamatrix.common.config.api.Configuration; -import com.metamatrix.common.log.LogConfiguration; -import com.metamatrix.common.queue.WorkerPoolStats; -import com.metamatrix.platform.admin.api.runtime.SystemState; -import com.metamatrix.platform.service.api.ServiceID; -import com.metamatrix.platform.vm.controller.ProcessStatistics; - -public interface RuntimeStateAdminAPI extends SubSystemAdminAPI { - - - /** - * Return TRUE if the system is started; i.e. at leat one of every essential services in a product is running. Authorization, - * Configuration, Membership and Session services are considered to be essential. - * - * @return Boolean - TRUE if system is started, FALSE if not. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - boolean isSystemStarted() throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Stop service once work is complete. - * - * @param callerSessionID - * ID of the caller's current session. - * @param serviceID - * ID of service instance. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void stopService(ServiceID serviceID) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Stop service now. - * - * @param callerSessionID - * ID of the caller's current session. - * @param serviceID - * ID of service instance. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void stopServiceNow(ServiceID serviceID) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Stop process once work is complete. - * - * @param callerSessionID - * ID of the caller's current session. - * @param processID - * <code>VMControllerID</code>. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void stopProcess(String hostname, String processName, boolean now) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Gracefully shutdown server waiting for work to complete. - * - * @param callerSessionID - * ID of the caller's current session. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void shutdownServer() throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Return the running state of the system. - * - * @return SysteState object that represents the system. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - SystemState getSystemState() throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Restart a failed or stopped service. - * - * @param serviceID - * ID of service instance. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void restartService(ServiceID serviceID) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Start up all processes and services for the host. - * - * @param host - * Host to start - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void startHost(String host) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Start up all process and services. - * - * @param host - * Host processes belongs to. - * @param process - * Processes to start - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void startProcess(String host, - String process) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Stop host processes/services once work is complete. - * - * @param host - * Name of host. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void stopHost(String host) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException, - MultipleException; - - /** - * Stop host processes/services now. - * - * @param host - * Name of host. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void stopHostNow(String host) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException, - MultipleException; - - /** - * Start up all services in psc. - * - * @param pscID - * PSC to start. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ -// void startPSC(PscID pscID) throws AuthorizationException, -// InvalidSessionException, -// MetaMatrixComponentException, -// MultipleException; -// - /** - * Stop up all services in psc, waiting for work to complete. - * - * @param pscID - * PSC to stop. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ -// void stopPSC(PscID pscID) throws AuthorizationException, -// InvalidSessionException, -// MetaMatrixComponentException, -// MultipleException; - - /** - * Stop up all services in psc now. - * - * @param pscID - * PSC to stop. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ -// void stopPSCNow(PscID pscID) throws AuthorizationException, -// InvalidSessionException, -// MetaMatrixComponentException, -// MultipleException; - - /** - * Synchronize running services with runtime configuration. - * - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void synchronizeServer() throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException, - MultipleException; - - /** - * Returns a Date object representing the time the server was started. If the server is not started a null is returned. - * - * @return Date - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - Date getServerStartTime() throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Sets the <code>LogConfiguration</code> on the given <code>Configuration</code>. If the configuration is - * <code>operational</code>, then the log configuration is set on the <code>Logmanager</code> running in each VM. - * - * @param config - * The configuration for which to set the log configuration. - * @param logConfig - * The log configuration with which to affect the log properties. - * @param actions - * The <code>Actions</code> from the <code>ConfigurationObjectEditor</code> used to affect the configuration - * database. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - void setLoggingConfiguration(Configuration config, - LogConfiguration logConfig, - List actions) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Return Collection of QueueStats for service. - * - * @param serviceID - * ID of the service. - * @return Collection of QueueStats objects. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - - Collection getServiceQueueStatistics(ServiceID serviceID) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Return QueueStats object for queue. - * - * @param serviceID - * ID of the service. - * @param queueName - * Name of queue. - * @return QueueStats object. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - WorkerPoolStats getServiceQueueStatistics(ServiceID serviceID, - String queueName) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Return VMStatistics object for Process. - * - * @param VMControllerID - * ID of the process. - * @return VMStatistics. - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - */ - ProcessStatistics getProcessStatistics(String hostName, String processName) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Return the PscID by Name - * - * @param hostName - * name of the host process for the PSC - * @param processName - * name of the process for the PSC - * @param pscName - * name of the PSC - * @return <PscID> - * @throws ServiceNotBoundException - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws AuthorizationException - * @throws MetaMatrixComponentException - * @since 4.2.1 - */ -// PscID getPscIDByName(String hostName, -// String processName, -// String pscName) throws InvalidSessionException, -// AuthorizationException, -// MetaMatrixComponentException; - - /** - * Return the ServiceID by Name - * - * @param hostName - * name of the host to that the service is configured - * @param processName - * process name of the service is configured - * @param serviceName - * name of the service to be retrieved - * @return <code>ServiceID</code> - * @throws AuthorizationException - * if caller is not authorized to perform this method. - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws MetaMatrixComponentException - * if an error occurred in communicating with a component. - * @since 4.2 - */ - ServiceID getServiceIDByName(String hostName, - String processName, - String serviceName) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - - /** - * Returns a list that contains all of the VMControllerBindings for all the VMControllers running in the MetaMatrix system. - * - * @return <code>List</code> of <code>VMControllerBinding</code>s - * @throws InvalidSessionException - * if the <code>callerSessionID</code> is not valid or is expired. - * @throws AuthorizationException - * @throws MetaMatrixComponentException - * @since 4.2.1 - */ - List getVMControllerBindings() throws InvalidSessionException, - AuthorizationException, - MetaMatrixComponentException; - - /** - * Get the log entries that match the specified criteria. - * @param startTime - * @param endTime If null, will ignore this criterion. - * @param levels List of Integers - * @param levels List of Strings. If null, will ignore this criterion and return entries with any context. - * @param maxRows - * @return List of LogEntry objects - * @since 4.3 - */ - List getLogEntries(Date startTime, - Date endTime, - List levels, - List contexts, - int maxRows) throws AuthorizationException, - InvalidSessionException, - MetaMatrixComponentException; - -} Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateChangeEvent.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateChangeEvent.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/RuntimeStateChangeEvent.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,34 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api; - -import java.util.EventObject; - -public class RuntimeStateChangeEvent extends EventObject{ - - public RuntimeStateChangeEvent(Object source){ - super(source); - } - -} - Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/SubSystemAdminAPI.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/SubSystemAdminAPI.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/SubSystemAdminAPI.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,33 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api; - - -/** - * This is the base interface of all subsystem administrative API interfaces. - * @deprecated - */ -public interface SubSystemAdminAPI { - -} - Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/ProductNotRegisteredException.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/ProductNotRegisteredException.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/ProductNotRegisteredException.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,53 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api.exception; - -import com.metamatrix.platform.security.api.SecurityPlugin; - -/** - * Indicates the named product is a known product, but is not registered at - * the MetaMatrix system. - */ -public class ProductNotRegisteredException extends MetaMatrixAdminException { - - private static final String exceptionMsg(String productName){ - return SecurityPlugin.Util.getString("ProductNotRegisteredException.Not_registered", productName); //$NON-NLS-1$ - } - - - /** - * No-arg CTOR - */ - public ProductNotRegisteredException( ) { - super( ); - } - /** - * Constructs an exception indicating a known product is not currently - * registered at the MetaMatrix system. - * @param productName name in question - */ - public ProductNotRegisteredException( String productName ) { - super( exceptionMsg(productName)); - } - -} Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/UnknownProductOrSubsystemException.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/UnknownProductOrSubsystemException.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/admin/api/exception/UnknownProductOrSubsystemException.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,67 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.admin.api.exception; - -import com.metamatrix.platform.security.api.SecurityPlugin; - -/** - * Indicates a product name has been encountered that - * is unknown, or a subsystem name for a <i>known</i> product has been - * encountered which is unknown <i>for that product</i>. - */ -public class UnknownProductOrSubsystemException extends MetaMatrixAdminException { - - private static final String unknownProductMsg(String unknownProduct){ - return SecurityPlugin.Util.getString("UnknownProductOrSubsystemException.Product_unknown", unknownProduct); //$NON-NLS-1$ - } - - private static final String unknownSubsystemMsg(String knownProduct, String unknownSubsystem){ - Object[] params = new Object[] {unknownSubsystem, knownProduct}; - return SecurityPlugin.Util.getString("UnknownProductOrSubsystemException.Subsystem_unknown", params); //$NON-NLS-1$ - } - - /** - * No-arg CTOR - */ - public UnknownProductOrSubsystemException( ) { - super( ); - } - - /** - * Constructs an exception indicating a product name is unknown - * @param unknownProduct name that is not known - */ - public UnknownProductOrSubsystemException( String unknownProduct ) { - super( unknownProductMsg(unknownProduct)); - } - - /** - * Constructs an exception indicating a subsystem for a known product - * is unknown - * @param knownProduct product name - * @param unknownSubsystem name that is not known for the product - */ - public UnknownProductOrSubsystemException( String knownProduct, String unknownSubsystem ) { - super( unknownSubsystemMsg(knownProduct, unknownSubsystem)); - } -} Deleted: trunk/common-internal/src/main/java/com/metamatrix/platform/vm/controller/ProcessStatistics.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/platform/vm/controller/ProcessStatistics.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/platform/vm/controller/ProcessStatistics.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,44 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.platform.vm.controller; - -import java.io.Serializable; - -import com.metamatrix.common.queue.WorkerPoolStats; - -/** - * VM statistics including: total memory, free memory, number of threads. - */ -public class ProcessStatistics implements Serializable { - public String name; - public long totalMemory = 0; - public long freeMemory = 0; - public int threadCount = 0; - - - public SocketListenerStats socketListenerStats = new SocketListenerStats(); - - public WorkerPoolStats processPoolStats = new WorkerPoolStats(); -} - - Deleted: trunk/common-internal/src/main/java/com/metamatrix/server/admin/api/RuntimeMetadataAdminAPI.java =================================================================== --- trunk/common-internal/src/main/java/com/metamatrix/server/admin/api/RuntimeMetadataAdminAPI.java 2009-09-24 13:21:57 UTC (rev 1477) +++ trunk/common-internal/src/main/java/com/metamatrix/server/admin/api/RuntimeMetadataAdminAPI.java 2009-09-24 14:40:50 UTC (rev 1478) @@ -1,321 +0,0 @@ -/* - * JBoss, Home of Professional Open Source. - * See the COPYRIGHT.txt file distributed with this work for information - * regarding copyright ownership. Some portions may be licensed - * to Red Hat, Inc. under one or more contributor license agreements. - * - * This library is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public - * License as published by the Free Software Foundation; either - * version 2.1 of the License, or (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA - * 02110-1301 USA. - */ - -package com.metamatrix.server.admin.api; - -import java.util.Collection; -import java.util.Map; -import java.util.Set; - -import com.metamatrix.admin.api.exception.security.InvalidSessionException; -import com.metamatrix.api.exception.MetaMatrixComponentException; -import com.metamatrix.api.exception.security.AuthorizationException; -import com.metamatrix.common.config.api.ConnectorBinding; -import com.metamatrix.common.vdb.api.VDBDefn; -import com.metamatrix.metadata.runtime.api.VirtualDatabase; -import com.metamatrix.metadata.runtime.api.VirtualDatabaseException; -import com.metamatrix.metadata.runtime.api.VirtualDatabaseID; -import com.metamatrix.platform.admin.api.EntitlementMigrationReport; -import com.metamatrix.platform.admin.api.PermissionDataNode; -import com.metamatrix.platform.admin.api.SubSystemAdminAPI; -import com.metamatrix.platform.security.api.AuthorizationPolicyID; - -public interface RuntimeMetadataAdminAPI extends SubSystemAdminAPI { - - /** - * Update a modified <code>VirtualDataBase</code>. - * - * @param vdb the modified VirtualDatabase. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while updating vdb. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - void updateVirtualDatabase(VirtualDatabase vdb) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Mark a <code>VirtualDataBase</code> (VDB) for deletion. - *<p></p> - * The VDB will not actually be deleted until there are no more users using it. - * @param vdbID the ID of the VirtualDatabase that is to be deleted. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while updating vdb. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - void markVDBForDelete(VirtualDatabaseID vdbID) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Migrate connector binding names from models in a virtual database, filling in connector - * binding names possible for the models in the DTCInfo. - * - * @param sourceVDB The source VirtualDatabase from which to search for models and thus, - * connector binding names. - * @param vdb represents a specific VDB Version - * @return A Map of ModelNames to RoutingIDs. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - Map migrateConnectorBindingNames(VirtualDatabase sourceVDB, VDBDefn vdb) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Set connector binding names for models in a virtual database. - * - * @param vdbID ID of the VirtualDatabase. - * @param modelnamesAndConnectorBindingNames Map of <code>ModelID</code>s to String Connector Binding names. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - void setConnectorBindingNames(VirtualDatabaseID vdbID, Map modelnamesAndConnectorBindingNames) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Given a routing ID, find all VDBs whose models use the connector binding. - * - * @param routingID ID of the connector binding. - * @return Collection of VDBs where at least one Model is using given connector binding. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - Collection getVDBsForConnectorBinding(String routingID) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Returns the <code>VirtualDatabase</code> specified by the <code>VirtualDatabaseID</code>. - * - * @param vdbID ID of the VirtualDatabase. - * @return VirtualDatabase - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - VirtualDatabase getVirtualDatabase(VirtualDatabaseID vdbID) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Returns the latest<code>VirtualDatabase</code> for the specified vdbName. - * - * @param callerSessionID ID of the caller's current session. - * @param vdbName is the name of the VirtualDatabase. - * @return VirtualDatabase - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - VirtualDatabase getLatestVirtualDatabase(String vdbName) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - - /** - * Returns a <code>Collection</code> of all the VirtualDatabases in the system. - * This would include all virtual databases flagged as incomplete, active, inactive or deleted. - * - * @return a Collection of all Virtualdatabases in the system. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - Collection getVirtualDatabases() - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Returns a sorted <code>Collection</code> of type <code>Model</code> that represents - * all the models that where deployed in the specified virtual database. - * - * @param vdbID ID of the VirtualDatabase. - * @return a Collection of all Models deployed in the VirtualDatabase. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - Collection getVDBModels(VirtualDatabaseID vdbID) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Updates the <code>VirtualDatabase</code> state. - * The following four states are valid. - * <p>Incomplete = 1: The virtula database is not fully created yet. Set by runtime metadata during the creation of a new virtual database.</p> - * <p>Inactive = 2: Not ready for use.</p> - * <p>Active = 3: Ready for use.</p> - * <p>Deleted =4: Ready for deletion.</p> - * - * @param vdbID ID of the VirtualDatabase. - * @param state the state the VirtualDatabase should be set to. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - void setVDBState(VirtualDatabaseID vdbID, short state) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Migrate as many existing entitlements as possible to a newly deployed VDB. - * @param sourceVDB The existing VDB from which to copy entitlements. - * @param targetVDB The new VDB to which to copy entitlements. - * @return The report that contains a result for each attempted copy. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - EntitlementMigrationReport migrateEntitlements(VirtualDatabase sourceVDB, VirtualDatabase targetVDB) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Migrate as many existing entitlements as possible from a supplied roles file to a newly deployed VDB. - * @param targetVDB The new VDB to which to copy entitlements. - * @param dataRoleContents Data Roles xml file contents. - * @param overwriteExisting flag to determine if any existing roles should be overwritten. - * @return The report that contains a result for each attempted copy. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - EntitlementMigrationReport migrateEntitlements(VirtualDatabase targetVDB, char[] dataRoleContents, boolean overwriteExisting) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Returns the entitlement tree for a given VDB version. - * @param vDBName The name of a VDB for which to get its model info. - * @param vDBVersion The name of a VDB version for which to get its model info. - * @param policyID The policy (entitlement) for which to constrain the search for permissions. - * @return The root of the entitlement tree for the given VEB version. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - PermissionDataNode getEntitlementTree(String vDBName, String vDBVersion, AuthorizationPolicyID policyID) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Get the tree of data nodes that make op a VDB. This tree represents <i>just</i> - * the data node hierarchy and does not contain authorization information. - * @param vdbName The name of the VDB for which data nodes are sought. - * @param vdbVersion The version of the VDB for which data nodes are sought. - * @return The root of the tree for the VDB and version. - * @throws InvalidSessionException if the administrative session is invalid - * @throws AuthorizationException if admninistrator does not have the authority to perform the requested operation. - * @throws MetaMatrixComponentException if this service has trouble communicating. - */ - PermissionDataNode getDataNodes(String vDBName, String vDBVersion) - throws AuthorizationException, InvalidSessionException, MetaMatrixComponentException; - - /** - * Get all data element paths for a VDB version. - * @param vdbName The VDB name. - * @param vdbVersion The version for the VDB. - * @return All element paths in the given VDB version. - */ - Set getAllDataNodeNames(String vdbName, String vdbVersion) - throws InvalidSessionException, MetaMatrixComponentException; - - /** - * Set the visibility levels for models in a virtual database. - * - * @param vdbID ID of the VirtualDatabase. - * @param modelAndVLevels Map of model names to Short visibility levels. - * Visibility levels are defined in MetadataConstants.VISIBILITY_TYPES. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ -// public void setModelVisibilityLevels(VirtualDatabaseID vdbID, Map modelAndVLevels) -// throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Call to obtain the VDB Definition that can be used - * for importing or exporting. - * - * @param vdbID ID of the VirtualDatabase. - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - public byte[] getVDB(VirtualDatabaseID vdbID ) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - - /** - * Call to import a VDB - * @param vdbDefn is the VDB to be imported, this includes any new connector or - * connector bindings. - * @returns VirtualDatabase that was imported - * @throws AuthorizationException if caller is not authorized to perform this method. - * @throws InvalidSessionException if the <code>callerSessionID</code> is not valid or is expired. - * @throws VirtualDatabaseException if an error occurs while setting the state. - * @throws MetaMatrixComponentException if an error occurs in communicating with a component. - */ - public VirtualDatabase importVDB(byte[] vdbStream) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Validate the given connector binding is capable for connectivity to a Materialization. - * @param materializationConnector The connector that will be validated. - * @return <code>true</code> iff the given connector binding passes validation. - * @throws AuthorizationException - * @throws InvalidSessionException - * @throws VirtualDatabaseException - * @throws MetaMatrixComponentException - * @since 4.2 - */ - boolean validateConnectorBindingForMaterialization(ConnectorBinding materializationConnector) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - - /** - * Get the <code>MaterializationLoadScripts</code> for all materialized views in the materialization model - * in this VDB. - * @param materializationConnector the connector that will be used to connect to the Materialization. - * @param vdb the VDB to which the Materialization belongs. - * @param mmHost The host that the MetaMatrix server is running on. - * @param mmPort The MetaMatrix server port. - * @param materializationUserName The name of the user that will be logging in to the database that - * holds this particular materialization and the user that the load/refresh scripts will run under. - * @param materializationUserPwd The password of the materialization user. - * @param metamatrixUserName User that will log into the MetaMatrix server to perform the refresh. - * @param metamatrixUserPwd Password of the MetaMatrix user. - * @return The object that represents all information nessecary to save the materialization load scripts. - * @throws AuthorizationException - * @throws InvalidSessionException - * @throws VirtualDatabaseException - * @throws MetaMatrixComponentException - * @since 4.2 - */ - MaterializationLoadScripts getMaterializationScripts(ConnectorBinding materializationConnector, VDBDefn vdb, - String mmHost, String mmPort, String materializationUserName, String materializationUserPwd, String metamatrixUserName, String metamatrixUserPwd) - throws AuthorizationException, InvalidSessionException, VirtualDatabaseException, MetaMatrixComponentException; - -}