Examples of speculoos.jndi.mappers.JNDIMapper

speculoos.jndi.mappers.JNDIMapper

Base implementation for mappings in the context of a JNDI data source.

This is the base implementation class for all JNDI/LDAP mappers. It contains common properties:

directory: The reference directory context this mapper operates on. This is set by the source attached to this mapper. This is a {@link javax.naming.directory.DirContext} instance.
root: The node this mapper operates on or from. This is a {@link speculoos.utils.VariableString} string that must be later oninstanciated by subclasses to yield a string.
environment: The base environment as set by the source upon creation. This must not be modified as environment may be shared across multiple mappers.
typeHelper: Eases reflexive manipulation of typed data.
nameParser: Extracted from the directory, this is a {@link javax.naming.NameParser}instance that may be used by subclasses.

Theses properties must never be modified by subclasses.

Subclasses must implement the {@link #clone()} method as itis used by the source to instantiate a mapper with immediate sharing of resources. This follows the Prototype design pattern as proposed in the GOF.

@author nono @version $Id: JNDIMapper.java 61 2005-10-21 14:54:44Z/C=FR/ST=Nord/L=Lille/O=Norsys SA/OU=UE/CN=Arnaud Bailly/emailAddress=abailly@norsys.fr $ @see javax.naming.directory.DirContext

  public synchronized Mapper create(String m, Map environment)
      throws MapperException {
    if (!bound)
      throw new IllegalStateException(
          "This source is not opened for business. Come back later");
    JNDIMapper base = (JNDIMapper) mapperMatrix.get(m);
    if (base == null)
      throw new IllegalArgumentException("Mapper named " + m
          + " is unknown");
    JNDIMapper jm = (JNDIMapper) (base).clone();
    /* sets the directory object to use for operations */
    JNDIConnection dirc;
    if (log.isDebugEnabled())
      log.info("[" + name + "] creating mapper " + m);
    try {
      dirc = connect();
      jm.setDirectory(dirc);
    } catch (NamingException e) {
      throw new MapperTechnicalException(
          "Cannot instantiate mapper " + m, e);
    }
    /* sets the environment */
    Map env = new HashMap(environment);
    env.putAll(current);
    jm.setEnvironment(env);
    if (log.isDebugEnabled())
      log.info("[" + name + "] created mapper " + m + " with env " + env);
    return jm;
  }

   * (non-Javadoc)
   * 
   * @see speculoos.core.core.spi.Source#release(speculoos.core.core.Mapper)
   */
  public void release(Mapper mapper) throws MapperException {
    JNDIMapper jm = (JNDIMapper) mapper;
    if (!mapperMatrix.containsKey(jm.getName()))
      throw new MapperException("[" + name + "] unknown mapper " + jm
          + " in this source ");
    jm.getDirectory().close();
    /* clean state of object */
    jm.clearDirectory();
    /* clear environment */
    jm.getEnvironment().clear();
    if (log.isDebugEnabled())
      log.info("[" + name + "] released mapper " + mapper.getName());
  }

Examples of speculoos.jndi.mappers.JNDIMapper

Related Classes of speculoos.jndi.mappers.JNDIMapper