Class OMAGServerAdminStoreServices

java.lang.Object
org.odpi.openmetadata.adminservices.server.OMAGServerAdminStoreServices

public class OMAGServerAdminStoreServices extends Object
OMAGServerAdminStoreServices provides the capability to store and retrieve configuration documents. A configuration document provides the configuration information for a server. By default, a server's configuration document is stored in its own file. However, it is possible to override the default location using setConfigurationStoreConnection. This override affects all server instances in this process.
  • Constructor Details

    • OMAGServerAdminStoreServices

      public OMAGServerAdminStoreServices()
  • Method Details

    • setDefaultOMAGServerConfig

      public VoidResponse setDefaultOMAGServerConfig(String userId, OMAGServerConfig defaultServerConfig)
      Override the default server configuration document.
      Parameters:
      userId - calling user.
      defaultServerConfig - values to include in every new configured server.
      Returns:
      void response
    • getDefaultOMAGServerConfig

      public OMAGServerConfigResponse getDefaultOMAGServerConfig(String userId)
      Return the default server configuration document.
      Parameters:
      userId - calling user
      Returns:
      OMAGServerConfig response
    • clearDefaultOMAGServerConfig

      public VoidResponse clearDefaultOMAGServerConfig(String userId)
      Clear the default configuration document.
      Parameters:
      userId - calling user
      Returns:
      void response
    • setPlaceholderVariables

      public VoidResponse setPlaceholderVariables(String userId, Map<String,String> placeholderVariables)
      Set up the placeholder variables that will be used on each server start up.
      Parameters:
      userId - calling user.
      placeholderVariables - map of variable name to value.
      Returns:
      void response
    • getPlaceholderVariables

      public StringMapResponse getPlaceholderVariables(String userId)
      Return the placeholder variables that will be used on each server start up.
      Parameters:
      userId - calling user
      Returns:
      string map response
    • clearPlaceholderVariables

      public VoidResponse clearPlaceholderVariables(String userId)
      Clear the placeholder variables.
      Parameters:
      userId - calling user
      Returns:
      void response
    • setConfigurationStoreConnection

      public VoidResponse setConfigurationStoreConnection(String userId, Connection connection)
      Override the default location of the configuration documents.
      Parameters:
      userId - calling user.
      connection - connection used to create and configure the connector that interacts with the real store.
      Returns:
      void response
    • getConfigurationStoreConnection

      public ConnectionResponse getConfigurationStoreConnection(String userId)
      Return the connection object for the configuration store. Null is returned if the server should use the default store.
      Parameters:
      userId - calling user
      Returns:
      connection response
    • clearConfigurationStoreConnection

      public VoidResponse clearConfigurationStoreConnection(String userId)
      Clear the connection object for the configuration store.
      Parameters:
      userId - calling user
      Returns:
      connection response
    • getServerConfig

      public OMAGServerConfig getServerConfig(String userId, String serverName, boolean adminCall, String methodName) throws OMAGInvalidParameterException, OMAGNotAuthorizedException, InvalidParameterException
      Retrieve any saved configuration for this server.
      Parameters:
      userId - calling user
      serverName - name of the server
      adminCall - flag to indicate whether the
      methodName - method requesting the server details
      Returns:
      configuration properties
      Throws:
      OMAGInvalidParameterException - problem with the configuration file
      OMAGNotAuthorizedException - user not authorized to make these changes
      InvalidParameterException
    • getServerConfigForStartUp

      public OMAGServerConfig getServerConfigForStartUp(String userId, String serverName, String methodName) throws OMAGInvalidParameterException, OMAGNotAuthorizedException, OMAGConfigurationErrorException
      Retrieve any saved configuration for this server.
      Parameters:
      userId - calling user
      serverName - name of the server
      methodName - method requesting the server details
      Returns:
      configuration properties
      Throws:
      OMAGInvalidParameterException - problem with the configuration file
      OMAGNotAuthorizedException - user not authorized to make these changes
      OMAGConfigurationErrorException - unable to parse the OMAGServerConfig
    • saveServerConfig

      public void saveServerConfig(String serverName, String methodName, OMAGServerConfig serverConfig) throws OMAGInvalidParameterException
      Save the server's config ...
      Parameters:
      serverName - name of the server
      methodName - method requesting the server details
      serverConfig - properties to save
      Throws:
      OMAGInvalidParameterException - problem with the config file