Source code: com/aendvari/cerberus/component/descriptor/MultiPartValue.java

   /*
    * MultiPartValue.java
    *
    * Copyright (c) 2001, 2002 Aendvari, Ltd. All Rights Reserved.
    *
    * See the file LICENSE for terms of use.
    *
    */
   
  package com.aendvari.cerberus.component.descriptor;
  
  import java.util.ArrayList;
  import java.util.Collection;
  import java.util.Iterator;
  
  /**
   * <p>Defines a multi-part value. The value is built from a series of literals and attribute.
   * Attributes allow portions of the property to be specified during component instantiation.</p>
   *
   * @author  Trevor Milne
   *
   */
  
  public class MultiPartValue
  {
    /** The various parts of the value. */
    protected ArrayList parts;
  
  
    /* Constructors. */
  
  
    /**
     * Constructs a <code>MultiPartValue</code> instance.
     *
     */
  
    public MultiPartValue()
    {
      parts = new ArrayList();
    }
  
    /**
     * Constructs a <code>MultiPartValue</code> instance as a copy of the one supplied.
     *
     * @param    value            The <code>MultiPartValue</code> to copy.
     *
     */
  
    public MultiPartValue(MultiPartValue value)
    {
      parts = new ArrayList();
  
      // copy value parts
      Iterator partIterator = value.getParts().iterator();
  
      while (partIterator.hasNext())
      {
        Part copyPart = (Part)partIterator.next();
        Part newPart = new Part(copyPart);
  
        parts.add(newPart);
      }
    }
  
  
    /* Accessors. */
  
  
    /* Value. */
  
    /**
     * Adds a literal to this value.
     *
     * @param    literal            A literal value to add to the value.
     *
     */
  
    public void addLiteral(String literal)
    {
      parts.add(new Part(Part.Type.Literal, literal));
    }
  
    /**
     * Adds an attribute to this value.
     *
     * @param    attribute          A name of a attribute to add to the value.
     *
     */
  
    public void addAttribute(String attribute)
    {
      parts.add(new Part(Part.Type.Attribute, attribute));
    }
  
    /**
     * Returns the parts of this value.
     *
     * @return                  A <code>Collection</code> of {@link Part Parts}.
    *
    */
 
   public Collection getParts()
   {
     return parts;
   }
 
   /**
    * Clears this multi part value.
    *
    */
 
   public void clear()
   {
     parts = new ArrayList();
   }
 
 
   /* Debug. */
 
 
   public String toString()
   {
     StringBuffer buffer = new StringBuffer();
 
     buffer.append("MultiPartValue=[");
 
     Iterator partIterator = parts.iterator();
 
     while (partIterator.hasNext())
     {
       Part part = (Part)partIterator.next();
 
       if (part.getType() == Part.Type.Literal)
       {
         buffer.append(part.getValue());
       }
       else
       {
         buffer.append("$");
         buffer.append(part.getValue());
         buffer.append("$");
       }
     }
 
     buffer.append("]");
 
     return buffer.toString();
   }
 
 
   /* Inner classes. */
 
 
   /**
    * <p>Describes a single part of the value. A part may be either a literal
    * or a attribute.<p>
    *
    */
 
   public static class Part
   {
     /** The type of the part. */
     protected int type;
 
     /** The value of the part. */
     protected String value;
 
 
     /* Constants. */
 
 
     /** Constants for the type of the part. */
     public interface Type
     {
       /** This part is a constant value. */
       public static final int Literal    = 1;
 
       /** This part is an attribute. */
       public static final int Attribute  = 2;
     }
 
 
     /* Constructors. */
 
 
     /**
      * Constructs a <code>Part</code> instance.
      *
      * @param    setType            The type of the part.
      * @param    setValue          The value of the part.
      *
      */
 
     public Part(int setType, String setValue)
     {
       type = setType;
       value = setValue;
     }
 
     /**
      * Constructs a <code>Part</code> instance from the one supplied.
      *
      * @param    part            The <code>Part</code> to copy.
      *
      */
 
     public Part(Part part)
     {
       type = part.getType();
       value = part.getValue();
     }
 
 
     /* Accessors. */
 
 
     /* Type. */
 
     public int getType()
     {
       return type;
     }
 
     /* Value. */
 
     public String getValue()
     {
       return value;
     }
   }
 }