Package org.glassfish.connectors.config

Interface ConnectorConnectionPool

    • Method Detail

      • getResourceAdapterName

        @NotNull
@NotNull String getResourceAdapterName()
        Gets the value of the resourceAdapterName property. This is the name of resource adapter. Name of .rar file is taken as the unique name for the resource adapter.
        Parameters:
        value - allowed object is String

      • getConnectionDefinitionName

        @NotNull
@NotNull String getConnectionDefinitionName()
        Gets the value of the connectionDefinitionName property. Unique name, identifying one connection-definition in a Resource Adapter. Currently this is ConnectionFactory type.
        Returns:
        possible object is String

      • getSteadyPoolSize

        @Min(0L)
@Min(0L) String getSteadyPoolSize()
        Gets the value of the steadyPoolSize property. Minimum and initial number of connections maintained in the pool
        Returns:
        possible object is String

      • getMaxPoolSize

        @Min(1L)
@Min(1L) String getMaxPoolSize()
        Gets the value of the maxPoolSize property. Maximum number of conections that can be created
        Returns:
        possible object is String

      • getMaxWaitTimeInMillis

        @Min(0L)
@Min(0L) String getMaxWaitTimeInMillis()
        Gets the value of the maxWaitTimeInMillis property. Amount of time the caller will wait before getting a connection timeout. The default is 60 seconds. A value of 0 will force caller to wait indefinitely.
        Returns:
        possible object is String

      • getPoolResizeQuantity

        @Min(1L)
@Min(1L) String getPoolResizeQuantity()
        Gets the value of the poolResizeQuantity property. Number of connections to be removed when idle-timeout-in-seconds timer expires. Connections that have idled for longer than the timeout are candidates for removal. When the pool size reaches steady-pool-size, the connection removal stops.
        Returns:
        possible object is String

      • getIdleTimeoutInSeconds

        @Min(1L)
@Max(2147483647L)
@Min(1L) @Max(2147483647L) String getIdleTimeoutInSeconds()
        Gets the value of the idleTimeoutInSeconds property. Maximum time in seconds, that a connection can remain idle in the pool. After this time, the pool implementation can close this connection. Note that this does not control connection timeouts enforced at the database server side. Adminsitrators are advised to keep this timeout shorter than the EIS connection timeout (if such timeouts are configured on the specific EIS), to prevent accumulation of unusable connection in Application Server.
        Returns:
        possible object is String

      • getFailAllConnections

        String getFailAllConnections()
        Gets the value of the failAllConnections property. Indicates if all connections in the pool must be closed should a single connection fail validation. The default is false. One attempt will be made to re-establish failed connections.
        Returns:
        possible object is String

      • getTransactionSupport

        String getTransactionSupport()
        Gets the value of the transactionSupport property. Indicates the level of transaction support that this pool will have. Possible values are "XATransaction", "LocalTransaction" & "NoTransaction" This attribute will override that transaction support attribute in the Resource Adapter in a downward compatible way, i.e it can support a lower or equal transaction level than specified in the RA, but not higher level
        Returns:
        possible object is String

      • getIsConnectionValidationRequired

        String getIsConnectionValidationRequired()
        Gets the value of the isConnectionValidationRequired property. This attribute specifies if the connection that is about to be returned is to be validated by the container,
        Returns:
        possible object is String

      • getValidateAtmostOncePeriodInSeconds

        @Min(0L)
@Min(0L) String getValidateAtmostOncePeriodInSeconds()
        Gets the value of the validateAtmostOncePeriodInSeconds property. Used to set the time-interval within which a connection is validated atmost once. Default is 0 which implies that it is not enabled.
        Returns:
        possible object is String

      • getConnectionLeakTimeoutInSeconds

        @Min(0L)
@Min(0L) String getConnectionLeakTimeoutInSeconds()
        Gets the value of the connectionLeakTimeoutInSeconds property. To aid user in detecting potential connection leaks by the application. When a connection is not returned back to the pool by the application within the specified period, it is assumed to be a potential leak and stack trace of the caller will be logged. Default is 0, which implies there is no leak detection, by default. A positive non-zero value turns on leak detection. Note however that, this attribute only detects if there is a connection leak. The connection can be reclaimed only if connection-leak-reclaim is set to true.
        Returns:
        possible object is String

      • getConnectionLeakReclaim

        String getConnectionLeakReclaim()
        Gets the value of the connectionLeakReclaim property. If enabled, connection will be reusable (put back into pool) after connection-leak-timeout-in-seconds occurs.
        Returns:
        possible object is String

      • getConnectionCreationRetryAttempts

        String getConnectionCreationRetryAttempts()
        Gets the value of the connectionCreationRetryAttempts property. The number of attempts to create a new connection. Default is 0, which implies no retries.
        Returns:
        possible object is String

      • getConnectionCreationRetryIntervalInSeconds

        String getConnectionCreationRetryIntervalInSeconds()
        Gets the value of the connectionCreationRetryIntervalInSeconds property. The time interval between retries while attempting to create a connection Default is 10 seconds. Effective when connection-creation-retry-attempts is greater than 0.
        Returns:
        possible object is String

      • setConnectionCreationRetryIntervalInSeconds

        void setConnectionCreationRetryIntervalInSeconds​(String value)
                                          throws PropertyVetoException
        Sets the value of the connectionCreationRetryIntervalInSeconds property.
        Parameters:
        value - allowed object is String
        Throws:
        PropertyVetoException

      • getLazyConnectionEnlistment

        String getLazyConnectionEnlistment()
        Gets the value of the lazyConnectionEnlistment property. Enlist a resource to the transaction only when it is actually used in a method, which avoids enlistment of connections that are not used in a transaction. This also prevents unnecessary enlistment of connections cached in the calling components. Default value is false.
        Returns:
        possible object is String

      • getLazyConnectionAssociation

        String getLazyConnectionAssociation()
        Gets the value of the lazyConnectionAssociation property. Connections are lazily associated when an operation is performed on them. Also, they are disassociated when the transaction is completed and a component method ends, which helps reuse of the physical connections. Default value is false.
        Returns:
        possible object is String

      • getAssociateWithThread

        String getAssociateWithThread()
        Gets the value of the associateWithThread property. Associate a connection with the thread such that when the same thread is in need of a connection, it can reuse the connection already associated with that thread, thereby not incurring the overhead of getting a connection from the pool.
        Returns:
        possible object is String

      • getPooling

        String getPooling()
        Gets the value of the pooling property. Property to disable pooling for the pool.
        Returns:
        possible object is String

      • getMatchConnections

        String getMatchConnections()
        Gets the value of the matchConnections property. To switch on/off connection matching for the pool. It can be set to false if the administrator knows that the connections in the pool will always be homogeneous and hence a connection picked from the pool need not be matched by the resource adapter. Default value is true.
        Returns:
        possible object is String

      • getMaxConnectionUsageCount

        @Min(0L)
@Max(2147483647L)
@Min(0L) @Max(2147483647L) String getMaxConnectionUsageCount()
        Gets the value of the maxConnectionUsageCount property. When specified, connections will be re-used by the pool for the specified number of times after which it will be closed. This is useful for instance, to avoid statement-leaks. Default value is 0, which implies the feature is not enabled.
        Returns:
        possible object is String

      • getDescription

        String getDescription()
        Gets the value of the description property.
        Returns:
        possible object is String

      • getSecurityMap

        @NotNull
@NotNull List<SecurityMap> getSecurityMap()
        Gets the value of the securityMap property.

        This accessor method returns a reference to the live list, not a snapshot. Therefore any modification you make to the returned list will be present inside the JAXB object. This is why there is not a set method for the securityMap property.

        For example, to add a new item, do as follows: 

            getSecurityMap().add(newItem);

        Objects of the following type(s) are allowed in the list SecurityMap

      • getProperty

        @ToDo(priority=IMPORTANT,
      details="Provide PropertyDesc for legal props")
@PropertiesDesc(props={})
List<Property> getProperty()
        Properties as per PropertyBag Properties are used to override the ManagedConnectionFactory javabean configuration settings. When one or more of these properties are specified, they are passed as is using set() methods to the Resource Adapter's ManagedConnectionfactory class (specified in ra.xml).
        Specified by:
        getProperty in interface PropertyBag
        Returns:
        the property list