<change id="new-attribute-for-StringArrayPropertyEditor">

      <api name="explorer"/>

      <summary>One can specify separator for property editor for <code>String[]</code> </summary>

      <version major="5" minor="6"/>

      <date day="18" month="2" year="2005"/>

      <author login="jtulach"/>

      <compatibility addition="yes" binary="compatible" semantic="compatible" source="compatible" />

      <description>

        One can specify an item separator for properties using string array editor. For example

        following code:

        <pre>

          Node.Property np = new Node.Property (String[].class, ...);

          np.setValue ("item.separator", "-");        

        </pre>

        separates items returned from <code>getAsText</code> and parsed by <code>setAsText</code>

        by <q>-</q>. List of supported parameters can be found 

        <a href="@TOP@org/openide/explorer/doc-files/api.html#core_editors_custom_parameters">here</a>.

      </description>

      <class package="org.openide.explorer.propertysheet" name="PropertyPanel"/>

      <issue number="56257" />

    </change>

	<TR> 

	    <TD rowspan='1'>java.lang.String[]</TD>

	    <TD>item.separator</TD>

	    <TD>String</TD>

	    <TD>Contains the separator that is used when composing individual

                items into <code>getAsText</code> value and parse the text

                when doing <code>setAsText</code>. Since version 5.6.

            </TD>

        </TR>

    private String separator = ",";

        readEnv (env.getFeatureDescriptor ());

    }

    final void readEnv (FeatureDescriptor d) {

        }

        Object v = d.getValue ("item.separator"); // NOI18N

        if (v instanceof String) {

            separator = (String)v;

/*

 *                 Sun Public License Notice

 * 

 * The contents of this file are subject to the Sun Public License

 * Version 1.0 (the "License"). You may not use this file except in

 * compliance with the License. A copy of the License is available at

 * http://www.sun.com/

 * 

 * The Original Code is NetBeans. The Initial Developer of the Original

 * Code is Sun Microsystems, Inc. Portions Copyright 1997-2004 Sun

 * Microsystems, Inc. All Rights Reserved.

 */

package org.netbeans.beaninfo.editors;

import junit.framework.*;

import java.awt.*;

import java.beans.*;

import java.util.*;

import javax.swing.JList;

import javax.swing.JScrollPane;

import org.openide.explorer.propertysheet.ExPropertyEditor;

import org.openide.explorer.propertysheet.PropertyEnv;

import org.openide.explorer.propertysheet.editors.XMLPropertyEditor;

import org.openide.nodes.Node;

/**

 *

 * @author jarda

 */

public class StringArrayEditorTest extends TestCase {

    static {

        PropertyEditorManager.registerEditor (String[].class, StringArrayEditor.class);

    }

    public StringArrayEditorTest (String testName) {

        super (testName);

    }

    protected void setUp () throws Exception {

    }

    protected void tearDown () throws Exception {

    }

    public static Test suite () {

        TestSuite suite = new TestSuite(StringArrayEditorTest.class);

        return suite;

    }

    public void testTheEditorHonoursSeparatorAttribute () throws Exception {

        NP np = new NP ();

        np.setValue ("item.separator", "-");

        PropertyEditor p = np.getPropertyEditor ();

        assertNotNull ("There is some editor", p);

        assertEquals ("It is StringArrayEditor", StringArrayEditor.class, p.getClass ());

        ((StringArrayEditor)p).readEnv (np);

        p.setAsText ("A-B");

        String[] value = (String[])p.getValue ();

        assertNotNull ("Values is there", value);

        if (value.length != 2 || !"A".equals (value[0]) || !"B".equals(value[1])) {

            fail ("Unexpected arrays: " + Arrays.asList (value));

        }

        p.setValue (new String[] { "X", "Y" });

        String t = np.getPropertyEditor ().getAsText ();

        if (!"X- Y".equals (t)) {

            fail ("Wrong text: " + t);

        }

    }

    class NP extends Node.Property {

        public String[] value;

        public NP () {

            super (String[].class);

        }

        public void setValue (Object val) throws IllegalAccessException, IllegalArgumentException, java.lang.reflect.InvocationTargetException {

            value = (String[])val;

        }

        public Object getValue () throws IllegalAccessException, java.lang.reflect.InvocationTargetException {

            return value;

        }

        public boolean canWrite () {

            return true;

        }

        public boolean canRead () {

            return true;

        }

    }

}