Class JndiManager

    • Method Detail

      • getDefaultManager

        public static JndiManager getDefaultManager()
        Gets the default JndiManager using the default InitialContext.
        Returns:
        the default JndiManager
      • getDefaultManager

        public static JndiManager getDefaultManager​(String name)
        Gets a named JndiManager using the default InitialContext.
        Parameters:
        name - the name of the JndiManager instance to create or use if available
        Returns:
        a default JndiManager
      • getJndiManager

        public static JndiManager getJndiManager​(String initialContextFactoryName,
                                                 String providerURL,
                                                 String urlPkgPrefixes,
                                                 String securityPrincipal,
                                                 String securityCredentials,
                                                 Properties additionalProperties)
        Gets a JndiManager with the provided configuration information.
        Parameters:
        initialContextFactoryName - Fully qualified class name of an implementation of InitialContextFactory.
        providerURL - The provider URL to use for the JNDI connection (specific to the above factory).
        urlPkgPrefixes - A colon-separated list of package prefixes for the class name of the factory class that will create a URL context factory
        securityPrincipal - The name of the identity of the Principal.
        securityCredentials - The security credentials of the Principal.
        additionalProperties - Any additional JNDI environment properties to set or null for none.
        Returns:
        the JndiManager for the provided parameters.
      • createProperties

        public static Properties createProperties​(String initialContextFactoryName,
                                                  String providerURL,
                                                  String urlPkgPrefixes,
                                                  String securityPrincipal,
                                                  String securityCredentials,
                                                  Properties additionalProperties)
        Creates JNDI Properties with the provided configuration information.
        Parameters:
        initialContextFactoryName - Fully qualified class name of an implementation of InitialContextFactory.
        providerURL - The provider URL to use for the JNDI connection (specific to the above factory).
        urlPkgPrefixes - A colon-separated list of package prefixes for the class name of the factory class that will create a URL context factory
        securityPrincipal - The name of the identity of the Principal.
        securityCredentials - The security credentials of the Principal.
        additionalProperties - Any additional JNDI environment properties to set or null for none.
        Returns:
        the Properties for the provided parameters.
        Since:
        2.9
      • releaseSub

        protected boolean releaseSub​(long timeout,
                                     TimeUnit timeUnit)
        Description copied from class: AbstractManager
        May be overridden by managers to perform processing while the manager is being released and the lock is held. A timeout is passed for implementors to use as they see fit.
        Overrides:
        releaseSub in class AbstractManager
        Parameters:
        timeout - timeout
        timeUnit - timeout time unit
        Returns:
        true if all resources were closed normally, false otherwise.
      • lookup

        public <T> T lookup​(String name)
                     throws NamingException
        Looks up a named object through this JNDI context.
        Type Parameters:
        T - the type of the object.
        Parameters:
        name - name of the object to look up.
        Returns:
        the named object if it could be located.
        Throws:
        NamingException - if a naming exception is encountered