Enum ClientConfig.Field

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description
      ACCESS_TOKEN
      the authentication token (if server requires authentication)
      BASE_URL
      The base url in the format host [ : port][ /path] of the PGX server REST end-point.
      CCTRACE_OUT
      [relevant for enable_cctrace] when cctrace is enabled, specifies a path to a file where cctrace should log to.
      CCTRACE_PRINT_STACKTRACES
      [relevant for enable_cctrace] when cctrace is enabled, print the stacktrace for each request and result
      CLIENT_SERVER_INTERACTION_MODE
      if async_polling the PGX client would poll the status of the future until it's completed.
      ENABLE_CCTRACE
      if true log every call to a Control or Core interface
      KEYSTORE
      path to the keystore to use for client connections.
      MAX_CLIENT_HTTP_CONNECTIONS
      Maximum number of connections to open to the PGX server
      PREFETCH_SIZE
      How many items should be prefetched in remote iterators.
      REALM_CLIENT_CONFIG
      implementation dependent configuration options for the realm client
      REMOTE_FUTURE_PENDING_RETRY_INTERVAL
      How many milliseconds to wait before sending another request in case a GET request for a PgxRemoteFuture receives a 202 - Accepted response
      REMOTE_FUTURE_TIMEOUT
      How long one GET request for a PgxRemoteFuture will be alive, until it times out and tries again.
      TLS_VERSION
      TLS version to be used by the client.
      TRUSTSTORE
      path to the truststore to use for client connections.
      UPLOAD_BATCH_SIZE
      How many items will be uploaded in a batch.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.Object getDefaultVal()
      Gets the default value of this field.
      java.util.List<java.lang.String> getKeyAliases()
      Gets the key aliases of this field which are also recognized during parsing.
      java.util.List<java.lang.String> getSingletonListKeyAliases()
      Gets the key aliases of this field which contain single values for lists and are also recognized during parsing.
      java.lang.Class<?> getType()
      Gets the type of this field.
      boolean isArray()
      Checks if this field is an array.
      boolean isHidden()
      Checks if this field should be hidden.
      boolean isPath()
      Checks if this field is a path.
      boolean isRequired()
      Checks if this field is required.
      boolean isSensitive()
      Checks if this field holds a sensitive data.
      java.lang.String toKey()
      Get the key of this field, which is how this field is represented in serialized form.
      java.lang.String toString()  
      static ClientConfig.Field valueOf​(java.lang.String name)
      Returns the enum constant of this type with the specified name.
      static ClientConfig.Field[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      • Methods inherited from class java.lang.Enum

        compareTo, equals, getDeclaringClass, hashCode, name, ordinal, valueOf
      • Methods inherited from class java.lang.Object

        getClass, notify, notifyAll, wait, wait, wait
    • Enum Constant Detail

      • BASE_URL

        public static final ClientConfig.Field BASE_URL
        The base url in the format host [ : port][ /path] of the PGX server REST end-point. If the base_url is null, the default will be used which points to embedded PGX instance.
      • PREFETCH_SIZE

        public static final ClientConfig.Field PREFETCH_SIZE
        How many items should be prefetched in remote iterators.
      • UPLOAD_BATCH_SIZE

        public static final ClientConfig.Field UPLOAD_BATCH_SIZE
        How many items will be uploaded in a batch. This is used in Core#addAllToCollection() and Core#setProperty()
      • REMOTE_FUTURE_TIMEOUT

        public static final ClientConfig.Field REMOTE_FUTURE_TIMEOUT
        How long one GET request for a PgxRemoteFuture will be alive, until it times out and tries again. Time in milliseconds, set it to zero for an infinite timeout. See HTTP Client SO_TIMEOUT for more details.
      • REMOTE_FUTURE_PENDING_RETRY_INTERVAL

        public static final ClientConfig.Field REMOTE_FUTURE_PENDING_RETRY_INTERVAL
        How many milliseconds to wait before sending another request in case a GET request for a PgxRemoteFuture receives a 202 - Accepted response
      • ENABLE_CCTRACE

        public static final ClientConfig.Field ENABLE_CCTRACE
        if true log every call to a Control or Core interface
      • CCTRACE_OUT

        public static final ClientConfig.Field CCTRACE_OUT
        [relevant for enable_cctrace] when cctrace is enabled, specifies a path to a file where cctrace should log to. If null it will use the default PGX logger on level TRACE. If it is the special value :stderr: it will log to stderr
      • CCTRACE_PRINT_STACKTRACES

        public static final ClientConfig.Field CCTRACE_PRINT_STACKTRACES
        [relevant for enable_cctrace] when cctrace is enabled, print the stacktrace for each request and result
      • KEYSTORE

        public static final ClientConfig.Field KEYSTORE
        path to the keystore to use for client connections. The keystore is used to authenticate this client at the PGX server if two-way SSL/TLS is enabled.
      • TRUSTSTORE

        public static final ClientConfig.Field TRUSTSTORE
        path to the truststore to use for client connections. The truststore is used to validate the server certificate if communicating over SSL/TLS.
      • ACCESS_TOKEN

        public static final ClientConfig.Field ACCESS_TOKEN
        the authentication token (if server requires authentication)
      • MAX_CLIENT_HTTP_CONNECTIONS

        public static final ClientConfig.Field MAX_CLIENT_HTTP_CONNECTIONS
        Maximum number of connections to open to the PGX server
      • CLIENT_SERVER_INTERACTION_MODE

        public static final ClientConfig.Field CLIENT_SERVER_INTERACTION_MODE
        if async_polling the PGX client would poll the status of the future until it's completed. If blocking the PGX client would send a request to directly get the value of the future and the server would block until the future result is ready
      • TLS_VERSION

        public static final ClientConfig.Field TLS_VERSION
        TLS version to be used by the client. For example, TLSv1.2
      • REALM_CLIENT_CONFIG

        public static final ClientConfig.Field REALM_CLIENT_CONFIG
        implementation dependent configuration options for the realm client
    • Method Detail

      • values

        public static ClientConfig.Field[] values()
        Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
        for (ClientConfig.Field c : ClientConfig.Field.values())
            System.out.println(c);
        
        Returns:
        an array containing the constants of this enum type, in the order they are declared
      • valueOf

        public static ClientConfig.Field valueOf​(java.lang.String name)
        Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
        Parameters:
        name - the name of the enum constant to be returned.
        Returns:
        the enum constant with the specified name
        Throws:
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        java.lang.NullPointerException - if the argument is null
      • getKeyAliases

        public java.util.List<java.lang.String> getKeyAliases()
        Description copied from interface: ConfigField
        Gets the key aliases of this field which are also recognized during parsing.
        Specified by:
        getKeyAliases in interface ConfigField
        Returns:
        the key aliases
      • getSingletonListKeyAliases

        public java.util.List<java.lang.String> getSingletonListKeyAliases()
        Description copied from interface: ConfigField
        Gets the key aliases of this field which contain single values for lists and are also recognized during parsing.
        Specified by:
        getSingletonListKeyAliases in interface ConfigField
        Returns:
        the singleton list key aliases
      • getType

        public java.lang.Class<?> getType()
        Description copied from interface: ConfigField
        Gets the type of this field.
        Specified by:
        getType in interface ConfigField
        Returns:
        the type
      • isRequired

        public boolean isRequired()
        Description copied from interface: ConfigField
        Checks if this field is required.
        Specified by:
        isRequired in interface ConfigField
        Returns:
        true, if required
      • isArray

        public boolean isArray()
        Description copied from interface: ConfigField
        Checks if this field is an array.
        Specified by:
        isArray in interface ConfigField
        Returns:
        true, if array
      • isPath

        public boolean isPath()
        Description copied from interface: ConfigField
        Checks if this field is a path.
        Specified by:
        isPath in interface ConfigField
        Returns:
        true, if path
      • getDefaultVal

        public java.lang.Object getDefaultVal()
        Description copied from interface: ConfigField
        Gets the default value of this field.
        Specified by:
        getDefaultVal in interface ConfigField
        Returns:
        the default value
      • toKey

        public java.lang.String toKey()
        Description copied from interface: ConfigField
        Get the key of this field, which is how this field is represented in serialized form.
        Specified by:
        toKey in interface ConfigField
        Returns:
        the key.
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Enum<ClientConfig.Field>
      • isSensitive

        public boolean isSensitive()
        Description copied from interface: ConfigField
        Checks if this field holds a sensitive data.
        Specified by:
        isSensitive in interface ConfigField
        Returns:
        true, if use for sensitive data
      • isHidden

        public boolean isHidden()
        Description copied from interface: ConfigField
        Checks if this field should be hidden. Hidden fields are used to hid desired field from the user and only allow it for internal usage.
        Specified by:
        isHidden in interface ConfigField
        Returns:
        true if field should be hidden, false otherwise