All Libraries | This Library | Package | Class | Use | Tree | Deprecated | Index | Grand Index | Help
|  | Foundation |
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.sas.services
Interface ServiceComponentConfigInterface

All Known Implementing Classes:
  AbstractServiceComponentConfig, SessionServiceInitObject

    public interface ServiceComponentConfigInterface

Interface describing operations which pertain to a foundation service's configuration metadata.

Since:
  1.1.3

Method Summary
`org.w3c.dom.Document` | `createDocument(com.sas.metadata.remote.ServiceComponent serviceComponent)` Creates an XML document representation of the service component's configuration.
`java.lang.String` | `getConfigName()` Gets the name of the configuration.
`org.w3c.dom.Document` | `getDocument()` Creates an XML document represention of foundation service component's configuration that provides the document Element.
`boolean` | `isConfigurationUpdateable()` Determines whether or not this service component's configuration is updateable.
`void` | `mergeConfigFromFile(com.sas.metadata.remote.ServiceComponent serviceComponent, java.io.File file)` Updates the service's configuration by adding new service configuration read from the specified file to the service component's pre-existing configuration.
`void` | `setConfigName(java.lang.String configName)` Sets the name of the configuration.
`void` | `writeServiceConfigToFile(java.io.File file, com.sas.metadata.remote.ServiceComponent serviceComponent)` Write the service's configuration to the specified output stream.

Method Detail

### isConfigurationUpdateable

    boolean isConfigurationUpdateable()

  Determines whether or not this service component's configuration is updateable.

  Returns:
    `true` if the service configuration is udpateable or `false` if the configuration may not be updated by merging a new configuration.

### getDocument

    org.w3c.dom.Document getDocument()
                                     throws ServiceException

  Creates an XML document represention of foundation service component's configuration that provides the document Element.

  Returns:
    Foundation service configuration document.
  Throws:
    `ServiceException` - if unable to create a document.

### createDocument

    org.w3c.dom.Document createDocument(com.sas.metadata.remote.ServiceComponent serviceComponent)
                                        throws ServiceException

  Creates an XML document representation of the service component's configuration.

  Parameters:
    `serviceComponent` - Service component's which will be queried for an XML configuration stored in an configuration property text store.
  Returns:
    XML document representation of the service configuration or `null` if a document is unavailable.
  Throws:
    `ServiceException` - if a failure occurred while attempting to create an XML document representation of the service configuration.

### mergeConfigFromFile

    void mergeConfigFromFile(com.sas.metadata.remote.ServiceComponent serviceComponent,
                             java.io.File file)
                             throws ServiceException

  Updates the service's configuration by adding new service configuration read from the specified file to the service component's pre-existing configuration.

  Parameters:
    `serviceComponent` - The service whose configuration is to be updated.
    `file` - File containing the service configuration which is to be added to the service component's current configuration. Note that only configuration data that is additive in nature can be appended. Configuration data that is non-additive will be ignored.
  Throws:
    `ServiceException` - if unable to update the service's configuration.

### writeServiceConfigToFile

    void writeServiceConfigToFile(java.io.File file,
                                  com.sas.metadata.remote.ServiceComponent serviceComponent)
                                  throws ServiceException

  Write the service's configuration to the specified output stream.

  Parameters:
    `file` - File to which the service's configuration is to be written.
    `serviceComponent` - Service component whose configuration is to be written to the specified file.
  Throws:
    `ServiceException` - in an exception is encountered writing the service component's configuration to the specified file.

### getConfigName

    java.lang.String getConfigName()

  Gets the name of the configuration.

  Returns:
    The name of this configuration.

### setConfigName

    void setConfigName(java.lang.String configName)

  Sets the name of the configuration.

  Parameters:
    `configName` - The name of this configuration.

All Libraries | This Library | Package | Class | Use | Tree | Deprecated | Index | Grand Index | Help
|  | Foundation |
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2009 SAS Institute Inc. All Rights Reserved.