Attachment #133723 for bug #228909

This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

View | Details | Raw Unified | Return to bug 228909
Collapse All | Expand All




        <class package="org.netbeans.spi.viewmodel" name="TableRendererModelFilter" />
        <issue number="186672"/>
    </change>
    <change>
        <api name="ViewModelAPI"/>
        <summary>Separate the value and HTML value and allow custom property editors.</summary>
        <version major="1" minor="42"/>
        <date day="30" month="4" year="2013"/>
        <author login="mentlicher"/>
        <compatibility binary="compatible" source="compatible" deletion="no" addition="yes" modification="no"/>
        <description>
            So far the HTML value is automatically retrieved from the value provided
            by the <code>TableModel</code> when the value is a <code>String</code>
            and contains HTML code. This is not flexible enough and therefore
            we separate the value and HTML value by introduction of <code>TableHTMLModel</code>
            and <code>TableHTMLModelFilter</code>.<br/>
            In addition to that, this API change also brings a prossibility
            to provide custom property editor, separately for every value.
            Two interfaces are introduced for this purpose: <code>TablePropertyEditorsModel</code>
            and <code>TablePropertyEditorsModelFilter</code>.<br/>
            This also implies, that <code>Models.CompoundModel</code> now implements
            <code>TableHTMLModel</code> and <code>TablePropertyEditorsModel</code>.<br/>
            In order to be able to fire changes in HTML value and also in r/w state,
            an additional constructor of <code>ModelEvent.TableValueChanged</code>
            is added, which takes the change mask. Three change masks are defined:
            <code>VALUE_MASK</code>, <code>HTML_VALUE_MASK</code> and <code>IS_READ_ONLY_MASK</code>.
            To get the change mask, <code>ModelEvent.TableValueChanged.getChange()</code>
            method is added.
        </description>
        <class package="org.netbeans.spi.viewmodel" name="TableHTMLModel" />
        <class package="org.netbeans.spi.viewmodel" name="TableHTMLModelFilter" />
        <class package="org.netbeans.spi.viewmodel" name="TablePropertyEditorsModel" />
        <class package="org.netbeans.spi.viewmodel" name="TablePropertyEditorsModelFilter" />
        <class package="org.netbeans.spi.viewmodel" name="ModelEvent" />
        <issue number="228909"/>
    </change>


</changes>

Lines 1-5 Link Here

(-)a/spi.viewmodel/manifest.mf (-1 / +1 lines)
1	Manifest-Version: 1.0	1	Manifest-Version: 1.0
2	OpenIDE-Module: org.netbeans.spi.viewmodel/2	2	OpenIDE-Module: org.netbeans.spi.viewmodel/2
3	OpenIDE-Module-Localizing-Bundle: org/netbeans/modules/viewmodel/Bundle.properties	3	OpenIDE-Module-Localizing-Bundle: org/netbeans/modules/viewmodel/Bundle.properties
4	OpenIDE-Module-Specification-Version: 1.41	4	OpenIDE-Module-Specification-Version: 1.42
5		5

Lines 951-961 Link Here

(-)a/spi.viewmodel/src/org/netbeans/modules/viewmodel/TreeModelNode.java (-29 / +51 lines)
951	firePropertyChange(null, null, null);	951	firePropertyChange(null, null, null);
952	}	952	}
953		953
954	void refreshColumn(String column) {	954	void refreshColumn(String column, int changeMask) {
955	synchronized (properties) {	955	synchronized (properties) {
956	properties.remove(column);	956	if ((ModelEvent.TableValueChanged.VALUE_MASK & changeMask) != 0) {
957	properties.remove(column + "#html");	957	properties.remove(column);
958	properties.remove(column + "#canWrite");	958	}
		959	if ((ModelEvent.TableValueChanged.HTML_VALUE_MASK & changeMask) != 0) {
		960	properties.remove(column + "#html");
		961	}
		962	if ((ModelEvent.TableValueChanged.IS_READ_ONLY_MASK & changeMask) != 0) {
		963	properties.remove(column + "#canWrite");
		964	}
959	}	965	}
960	firePropertyChange(column, null, null);	966	firePropertyChange(column, null, null);
961	}	967	}
Lines 1869-1882 Link Here
1869	public void run() {	1875	public void run() {
1870	Object value = "";	1876	Object value = "";
1871	String htmlValue = null;	1877	String htmlValue = null;
1872	String nonHtmlValue = null;	1878	Object nonHtmlValue = null;
1873	try {	1879	try {
1874	//System.err.println("getValueAt("+object+", "+id+") of node "+TreeModelNode.this);	1880	//System.err.println("getValueAt("+object+", "+id+") of node "+TreeModelNode.this);
1875	value = model.getValueAt (object, id);	1881	value = model.getValueAt (object, id);
		1882	nonHtmlValue = value;
		1883	boolean hasHTML = model.hasHTMLValueAt(object, id);
		1884	if (hasHTML) {
		1885	htmlValue = model.getHTMLValueAt(object, id);
		1886	}
1876	//System.err.println(" Value of ("+object+") executed in "+Thread.currentThread()+" is "+value);	1887	//System.err.println(" Value of ("+object+") executed in "+Thread.currentThread()+" is "+value);
1877	//System.out.println(" evaluateLazily("+TreeModelNode.this.getDisplayName()+", "+id+"): have value = "+value);	1888	//System.out.println(" evaluateLazily("+TreeModelNode.this.getDisplayName()+", "+id+"): have value = "+value);
1878	//System.out.println(" object = "+object+" class = "+((object != null) ? object.getClass().toString() : "null"));	1889	//System.out.println(" object = "+object+" class = "+((object != null) ? object.getClass().toString() : "null"));
1879	if (value instanceof String) {	1890	if (!hasHTML && (value instanceof String)) { // For backward compatibility
1880	htmlValue = htmlValue ((String) value);	1891	htmlValue = htmlValue ((String) value);
1881	nonHtmlValue = removeHTML ((String) value);	1892	nonHtmlValue = removeHTML ((String) value);
1882	}	1893	}
Lines 1893-1904 Link Here
1893	//evaluatedNotify.run();	1904	//evaluatedNotify.run();
1894	boolean fire;	1905	boolean fire;
1895	synchronized (properties) {	1906	synchronized (properties) {
1896	if (value instanceof String) {	1907	properties.put (id, nonHtmlValue);
1897	properties.put (id, nonHtmlValue);	1908	properties.put (id + "#html", htmlValue);
1898	properties.put (id + "#html", htmlValue);
1899	} else {
1900	properties.put (id, value);
1901	}
1902	synchronized (evaluated) {	1909	synchronized (evaluated) {
1903	fire = evaluated[0] == -1;	1910	fire = evaluated[0] == -1;
1904	evaluated[0] = 1;	1911	evaluated[0] = 1;
Lines 1992-2004 Link Here
1992	private Object getTheValue() {	1999	private Object getTheValue() {
1993	Object value = "";	2000	Object value = "";
1994	String htmlValue = null;	2001	String htmlValue = null;
1995	String nonHtmlValue = null;	2002	Object nonHtmlValue = null;
1996	try {	2003	try {
1997	value = model.getValueAt (object, id);	2004	value = model.getValueAt (object, id);
		2005	nonHtmlValue = value;
		2006	boolean hasHTML = model.hasHTMLValueAt(object, id);
		2007	if (hasHTML) {
		2008	htmlValue = model.getHTMLValueAt(object, id);
		2009	}
1998	//System.err.println(" Value of ("+object+") executed in "+Thread.currentThread()+" is "+value);	2010	//System.err.println(" Value of ("+object+") executed in "+Thread.currentThread()+" is "+value);
1999	//System.out.println(" evaluateLazily("+TreeModelNode.this.getDisplayName()+", "+id+"): have value = "+value);	2011	//System.out.println(" evaluateLazily("+TreeModelNode.this.getDisplayName()+", "+id+"): have value = "+value);
2000	//System.out.println(" object = "+object+" class = "+((object != null) ? object.getClass().toString() : "null"));	2012	//System.out.println(" object = "+object+" class = "+((object != null) ? object.getClass().toString() : "null"));
2001	if (value instanceof String) {	2013	if (!hasHTML && (value instanceof String)) { // For backward compatibility
2002	htmlValue = htmlValue ((String) value);	2014	htmlValue = htmlValue ((String) value);
2003	nonHtmlValue = removeHTML ((String) value);	2015	nonHtmlValue = removeHTML ((String) value);
2004	}	2016	}
Lines 2008-2019 Link Here
2008	}	2020	}
2009	} finally {	2021	} finally {
2010	synchronized (properties) {	2022	synchronized (properties) {
2011	if (value instanceof String) {	2023	properties.put (id, nonHtmlValue);
2012	properties.put (id, nonHtmlValue);	2024	properties.put (id + "#html", htmlValue);
2013	properties.put (id + "#html", htmlValue);
2014	} else {
2015	properties.put (id, value);
2016	}
2017	}	2025	}
2018	}	2026	}
2019	return value;	2027	return value;
Lines 2124-2136 Link Here
2124	Object v = value;	2132	Object v = value;
2125	model.setValueAt (object, id, v);	2133	model.setValueAt (object, id, v);
2126	v = model.getValueAt(object, id); // Store the new value	2134	v = model.getValueAt(object, id); // Store the new value
		2135	String htmlValue = null;
		2136	Object nonHtmlValue = v;
		2137	boolean hasHTML = model.hasHTMLValueAt(object, id);
		2138	if (hasHTML) {
		2139	htmlValue = model.getHTMLValueAt(object, id);
		2140	}
		2141	if (!hasHTML && (v instanceof String)) { // For backward compatibility
		2142	htmlValue = htmlValue ((String) v);
		2143	nonHtmlValue = removeHTML ((String) v);
		2144	}
2127	synchronized (properties) {	2145	synchronized (properties) {
2128	if (v instanceof String) {	2146	properties.put (id, nonHtmlValue);
2129	properties.put (id, removeHTML ((String) v));	2147	properties.put (id + "#html", htmlValue);
2130	properties.put (id + "#html", htmlValue ((String) v));
2131	} else {
2132	properties.put (id, v);
2133	}
2134	}	2148	}
2135	firePropertyChange (propertyId, null, null);	2149	firePropertyChange (propertyId, null, null);
2136	} catch (UnknownTypeException e) {	2150	} catch (UnknownTypeException e) {
Lines 2140-2150 Link Here
2140		2154
2141	@Override	2155	@Override
2142	public PropertyEditor getPropertyEditor () {	2156	public PropertyEditor getPropertyEditor () {
2143	PropertyEditor pe = columnModel.getPropertyEditor ();	2157	PropertyEditor pe = null;
		2158	try {
		2159	pe = model.getPropertyEditor(object, id);
		2160	} catch (UnknownTypeException ex) {
		2161	Logger.getLogger(TreeModelNode.class.getName()).log(Level.CONFIG, "Column id:" + columnModel.getID ()+"\nModel: "+model, ex);
		2162	}
2144	if (pe == null) {	2163	if (pe == null) {
		2164	pe = columnModel.getPropertyEditor ();
		2165	}
		2166	if (pe != null) {
		2167	return pe;
		2168	} else {
2145	return super.getPropertyEditor();	2169	return super.getPropertyEditor();
2146	} else {
2147	return pe;
2148	}	2170	}
2149	}	2171	}
2150		2172

Lines 334-343 Link Here

(-)a/spi.viewmodel/src/org/netbeans/modules/viewmodel/TreeModelRoot.java (-1 / +2 lines)
334	if (node != null) {	334	if (node != null) {
335	TreeModelNode[] tmNodes = findNode(node);	335	TreeModelNode[] tmNodes = findNode(node);
336	//System.err.println(" nodes = "+Arrays.toString(tmNodes));	336	//System.err.println(" nodes = "+Arrays.toString(tmNodes));
		337	int change = tvEvent.getChange();
337	for (TreeModelNode tmNode : tmNodes) {	338	for (TreeModelNode tmNode : tmNodes) {
338	String column = tvEvent.getColumnID();	339	String column = tvEvent.getColumnID();
339	if (column != null) {	340	if (column != null) {
340	tmNode.refreshColumn(column);	341	tmNode.refreshColumn(column, change);
341	} else {	342	} else {
342	tmNode.refresh(model);	343	tmNode.refresh(model);
343	}	344	}




     */
    public static class TableValueChanged extends ModelEvent {
        
        /**
         * The mask for value change.
         * @since 1.42
         */
        public static final int VALUE_MASK = 1;
        /**
         * The mask for HTML value change.
         * @since 1.42
         */
        public static final int HTML_VALUE_MASK = 2;
        /**
         * The mask for change of the read only state.
         * @since 1.42
         */
        public static final int IS_READ_ONLY_MASK = 4;
        
        private Object node;
        private String columnID;
        private int change;
        
        /**
         * Creates a new instance of TableValueChanged event.

            Object node,
            String columnID
        ) {
            this(source, node, columnID, 0xffffffff);
        }
        
        /**
         * Creates a new instance of TableValueChanged event.
         *
         * @param source a source if event.
         * @param node a changed node instance
         * @param columnID a changed column name
         * @param change one of the *_MASK constants or their aggregation.
         * @since 1.42
         */
        public TableValueChanged (
            Object source, 
            Object node,
            String columnID,
            int change
        ) {
            super (source);
            this.node = node;
            this.columnID = columnID;
            this.change = change;
        }
        
        /**

        public String getColumnID () {
            return columnID;
        }
        
        /**
         * Get the change mask.
         *
         * @return the change mask, one of the *_MASK constants or their aggregation.
         * @since 1.42
         */
        public int getChange() {
            return change;
        }
    }
    
    /**




import java.awt.datatransfer.Transferable;
import java.awt.dnd.DnDConstants;
import java.awt.event.ActionEvent;
import java.beans.PropertyEditor;
import java.io.IOException;
import java.lang.ref.Reference;
import java.lang.ref.WeakReference;

        // ; or the models directly
        boolean hasLists = false;
        int modelsSize = models.size();
        if (11 <= modelsSize && modelsSize <= 18) {
            Iterator it = models.iterator ();
            boolean failure = false;
            while (it.hasNext ()) {

                            ml.tableRendererModels = (List<TableRendererModel>) models.get(13);
                            if (modelsSize > 14) {
                                ml.tableRendererModelFilters = (List<TableRendererModelFilter>) models.get(14);
                                //if (modelsSize > 15) {
                                //    ml.tableHtmlModels = (List<TableHTMLModel>) models.get(15);
                                    if (modelsSize > 15) {
                                        ml.tableHtmlModelFilters = (List<TableHTMLModelFilter>) models.get(15);
                                        if (modelsSize > 16) {
                                            ml.tablePropertyEditorsModels = (List<TablePropertyEditorsModel>) models.get(16);
                                            if (modelsSize > 17) {
                                                ml.tablePropertyEditorsModelFilters = (List<TablePropertyEditorsModelFilter>) models.get(17);
                                            }
                                        }
                                    }
                                //}
                            }
                        }
                    }

                new DefaultAsynchronousModel(),//new DelegatingAsynchronousModel (ml.asynchModels),
                ml.asynchModelFilters
            ),
            null, null,
            propertiesHelpID
        );
        } else {

            ml.columnModels,
            createCompoundTableModel (
                new DelegatingTableModel (ml.tableModels),
                ml.tableModelFilters,
                ml.tableHtmlModelFilters
            ),
            createCompoundAsynchronousModel (
                new DefaultAsynchronousModel(),//new DelegatingAsynchronousModel (ml.asynchModels),

                new DelegatingTableRendererModel(ml.tableRendererModels),
                ml.tableRendererModelFilters
            ),
            /*createCompoundTableHTMLModel (
                new DelegatingTableHTMLModel(ml.tableHtmlModels),
                ml.tableHtmlModelFilters
            ),*/
            createCompoundTablePropertyEditorModel (
                new DelegatingTablePropertyEditorsModel(ml.tablePropertyEditorsModels),
                ml.tablePropertyEditorsModelFilters
            ),
            propertiesHelpID
        );
        }

     *
     * @returns compound table model
     */
    private static TableHTMLModel createCompoundTableModel (
        TableHTMLModel originalTableModel,
        List tableModelFilters,
        List tableHtmlModelFilters
    ) {
        TableHTMLModel tm = originalTableModel;
        int i, k = tableModelFilters.size ();
        for (i = 0; i < k; i++) {
            tm = new CompoundTableModel (

                (TableModelFilter) tableModelFilters.get (i)
            );
        }
        k = tableHtmlModelFilters.size ();
        for (i = 0; i < k; i++) {
            tm = new CompoundTableModel (
                tm,
                (TableHTMLModelFilter) tableHtmlModelFilters.get (i)
            );
        }
        return tm;
    }
    

        }
        return tm;
    }
    
    private static TablePropertyEditorsModel createCompoundTablePropertyEditorModel (
        TablePropertyEditorsModel originalTableModel,
        List tableModelFilters
    ) {
        TablePropertyEditorsModel tm = originalTableModel;
        int i, k = tableModelFilters.size ();
        for (i = 0; i < k; i++) {
            tm = new CompoundTablePropertyEditorsModel (
                tm,
                (TablePropertyEditorsModelFilter) tableModelFilters.get (i)
            );
        }
        return tm;
    }

    /**
     * Creates {@link org.netbeans.spi.viewmodel.NodeActionsProvider} for given NodeActionsProvider and

        } else if (event instanceof ModelEvent.TableValueChanged) {
            newEvent = new ModelEvent.TableValueChanged(newSource,
                    ((ModelEvent.TableValueChanged) event).getNode(),
                    ((ModelEvent.TableValueChanged) event).getColumnID(),
                    ((ModelEvent.TableValueChanged) event).getChange());
        } else if (event instanceof ModelEvent.TreeChanged) {
            newEvent = new ModelEvent.TreeChanged(newSource);
        } else {

     * 
     * @author   Jan Jancura
     */
    private final static class CompoundTableModel implements TableHTMLModel, ModelListener {


        private TableHTMLModel model;
        private TableModelFilter filter;
        private TableHTMLModelFilter htmlFilter;

        private final Collection<ModelListener> modelListeners = new HashSet<ModelListener>();


         * Creates {@link org.netbeans.spi.viewmodel.TableModel} for given TableModel and
         * {@link org.netbeans.spi.viewmodel.TableModelFilter}.
         */
        CompoundTableModel (TableHTMLModel model, TableModelFilter filter) {
            this.model = model;
            this.filter = filter;
        }
    
        CompoundTableModel (TableHTMLModel model, TableHTMLModelFilter htmlFilter) {
            this.model = model;
            this.htmlFilter = htmlFilter;
        }
    
        /**
         * Returns value to be displayed in column <code>columnID</code>
         * and row <code>node</code>. Column ID is defined in by 

        @Override
        public Object getValueAt (Object node, String columnID) throws 
        UnknownTypeException {
            if (filter != null) {
                return filter.getValueAt (model, node, columnID);
            } else {
                return model.getValueAt(node, columnID);
            }
        }

        @Override
        public boolean hasHTMLValueAt(Object node, String columnID) throws UnknownTypeException {
            if (htmlFilter != null) {
                return htmlFilter.hasHTMLValueAt(model, node, columnID);
            } else {
                return model.hasHTMLValueAt(node, columnID);
            }
        }

        @Override
        public String getHTMLValueAt(Object node, String columnID) throws UnknownTypeException {
            if (htmlFilter != null) {
                return htmlFilter.getHTMLValueAt(model, node, columnID);
            } else {
                return model.getHTMLValueAt(node, columnID);
            }
        }

        /**

        @Override
        public boolean isReadOnly (Object node, String columnID) throws 
        UnknownTypeException {
            if (filter != null) {
                return filter.isReadOnly (model, node, columnID);
            } else {
                return model.isReadOnly(node, columnID);
            }
        }

        /**

        @Override
        public void setValueAt (Object node, String columnID, Object value) 
        throws UnknownTypeException {
            if (filter != null) {
                filter.setValueAt (model, node, columnID, value);
            } else {
                model.setValueAt(node, columnID, value);
            }
        }

        /** 

        public void addModelListener (ModelListener l) {
            synchronized (modelListeners) {
                if (modelListeners.isEmpty()) {
                    if (filter != null) {
                        filter.addModelListener (this);
                    }
                    model.addModelListener (this);
                }
                modelListeners.add(l);

            synchronized (modelListeners) {
                modelListeners.remove(l);
                if (modelListeners.isEmpty()) {
                    if (filter != null) {
                        filter.removeModelListener (this);
                    }
                    model.removeModelListener (this);
                }
            }

        }
        
        public String toString (String n) {
            Model theFilter = (filter != null) ? filter : htmlFilter;
            if (model instanceof CompoundTableModel) {
                return n + theFilter + "\n" +
                    ((CompoundTableModel) model).toString (n + "  ");
            }
            if (model instanceof DelegatingTableModel) {
                return n + theFilter + "\n" +
                    ((DelegatingTableModel) model).toString (n + "  ");
            }
            return n + theFilter + "\n" + 
                   n + "  " + model;
        }
    }

        }
    }
    
    private final static class CompoundTablePropertyEditorsModel implements TablePropertyEditorsModel {
        
        private TablePropertyEditorsModel model;
        private TablePropertyEditorsModelFilter filter;
        
        CompoundTablePropertyEditorsModel(TablePropertyEditorsModel model, TablePropertyEditorsModelFilter filter) {
            this.model = model;
            this.filter = filter;
        }

        @Override
        public PropertyEditor getPropertyEditor(Object node, String columnID) throws UnknownTypeException {
            return filter.getPropertyEditor(model, node, columnID);
        }
        
        @Override
        public String toString () {
            return super.toString () + "\n" + toString ("    ");
        }

        public String toString (String n) {
            if (model instanceof CompoundTablePropertyEditorsModel) {
                return n + filter + "\n" +
                    ((CompoundTablePropertyEditorsModel) model).toString (n + "  ");
            }
            if (model instanceof DelegatingTablePropertyEditorsModel) {
                return n + filter + "\n" +
                    ((DelegatingTablePropertyEditorsModel) model).toString (n + "  ");
            }
            return n + filter + "\n" +
                   n + "  " + model;
        }
    }
    
    /**
     * Creates {@link org.netbeans.spi.viewmodel.NodeActionsProvider} 
     * for given NodeActionsProvider and

     *
     * @author   Jan Jancura
     */
    private final static class DelegatingTableModel implements TableModel, TableHTMLModel {

        private TableModel[] models;
        private HashMap<String, TableModel> classNameToModel = new HashMap<String, TableModel>();

            sb.append (models [i]);
            return new String (sb);
        }
        
        // HTML extension:

        private boolean defaultHasHTMLValueAt() {
            return false;
        }
        
        @Override
        public boolean hasHTMLValueAt(Object node, String columnID) throws UnknownTypeException {
            UnknownTypeException uex = null;
            TableModel model = classNameToModel.get (
                node.getClass ().getName ()
            );
            if (model != null) {
                if (model instanceof TableHTMLModel) {
                    try {
                        return ((TableHTMLModel) model).hasHTMLValueAt(node, columnID);
                    } catch (UnknownTypeException e) {
                        uex = e;
                    }
                } else {
                    return defaultHasHTMLValueAt();
                }
            }
            int i, k = models.length;
            boolean isHTML = false;
            for (i = 0; i < k; i++) {
                if (models[i] instanceof TableHTMLModel) {
                    try {
                        boolean has = ((TableHTMLModel) models [i]).hasHTMLValueAt(node, columnID);
                        classNameToModel.put (node.getClass ().getName (), models [i]);
                        return has;
                    } catch (UnknownTypeException e) {
                        uex = e;
                    }
                    isHTML = true;
                }
            }
            if (!isHTML) {
                return defaultHasHTMLValueAt();
            }
            if (uex != null) {
                throw uex;
            } else {
                throw new UnknownTypeException (node);
            }
        }

        @Override
        public String getHTMLValueAt(Object node, String columnID) throws UnknownTypeException {
            UnknownTypeException uex = null;
            TableModel model = classNameToModel.get (
                node.getClass ().getName ()
            );
            if (model != null) {
                if (model instanceof TableHTMLModel) {
                    try {
                        return ((TableHTMLModel) model).getHTMLValueAt(node, columnID);
                    } catch (UnknownTypeException e) {
                        uex = e;
                    }
                } else {
                    return null;
                }
            }
            int i, k = models.length;
            boolean isHTML = false;
            for (i = 0; i < k; i++) {
                if (models[i] instanceof TableHTMLModel) {
                    try {
                        String htmlValue = ((TableHTMLModel) models [i]).getHTMLValueAt(node, columnID);
                        classNameToModel.put (node.getClass ().getName (), models [i]);
                        return htmlValue;
                    } catch (UnknownTypeException e) {
                        uex = e;
                    }
                    isHTML = true;
                }
            }
            if (!isHTML) {
                return null;
            }
            if (uex != null) {
                throw uex;
            } else {
                throw new UnknownTypeException (node);
            }
        }
    }

    /**

        }

    }
    
    private final static class DelegatingTablePropertyEditorsModel implements TablePropertyEditorsModel {
        
        private TablePropertyEditorsModel[] models;
        private HashMap<String, TablePropertyEditorsModel> classNameToModel = new HashMap<String, TablePropertyEditorsModel>();
        
        DelegatingTablePropertyEditorsModel(List<TablePropertyEditorsModel> models) {
            this(convert(models));
        }
        
        private static TablePropertyEditorsModel[] convert(List<TablePropertyEditorsModel> l) {
            TablePropertyEditorsModel[] models = new TablePropertyEditorsModel[l.size()];
            return l.toArray(models);
        }
        
        DelegatingTablePropertyEditorsModel(TablePropertyEditorsModel[] models) {
            this.models = models;
        }

        @Override
        public PropertyEditor getPropertyEditor(Object node, String columnID) throws UnknownTypeException {
            UnknownTypeException utex = null;
            TablePropertyEditorsModel model = classNameToModel.get(
                    node.getClass().getName()
            );
            if (model != null) {
                try {
                    return model.getPropertyEditor(node, columnID);
                } catch (UnknownTypeException e) {
                    utex = e;
                }
            }
            int i, k = models.length;
            for (i = 0; i < k; i++) {
                try {
                    PropertyEditor pe = models [i].getPropertyEditor(node, columnID);
                    classNameToModel.put (node.getClass ().getName (), models [i]);
                    return pe;
                } catch (UnknownTypeException e) {
                    utex = e;
                }
            }
            if (k == 0) {
                return null;
            }
            if (utex != null) {
                throw utex;
            } else {
                throw new UnknownTypeException (node);
            }
        }

        @Override
        public String toString () {
            return super.toString () + "\n" + toString ("    ");
        }

        public String toString (String n) {
            int i, k = models.length - 1;
            if (k == -1) {
                return "";
            }
            StringBuffer sb = new StringBuffer ();
            for (i = 0; i < k; i++) {
                sb.append (n);
                sb.append (models [i]);
                sb.append ('\n');
            }
            sb.append (n);
            sb.append (models [i]);
            return new String (sb);
        }
    }

    /**
     * Creates one {@link org.netbeans.spi.viewmodel.TableModel}

                                                       CheckNodeModel,
                                                       DnDNodeModel,
                                                       NodeActionsProvider,
                                                       TableHTMLModel,
                                                       TreeExpansionModel,
                                                       TableRendererModel,
                                                       TablePropertyEditorsModel {

        private ReorderableTreeModel treeModel;
        private ExtendedNodeModel nodeModel;

        private DnDNodeModel    dndNodeModel;
        private NodeActionsProvider nodeActionsProvider;
        private ColumnModel[]   columnModels;
        private TableHTMLModel  tableModel;
        private TableRendererModel tableRendererModel;
        private TablePropertyEditorsModel tablePropertyEditorsModel;
        private TreeExpansionModel treeExpansionModel;
        private AsynchronousModel asynchModel;


            ExtendedNodeModel nodeModel, 
            NodeActionsProvider nodeActionsProvider,
            List<ColumnModel> columnModels,
            TableHTMLModel tableModel,
            AsynchronousModel asynchModel,
            TableRendererModel tableRendererModel,
            TablePropertyEditorsModel tablePropertyEditorsModel,
            String propertiesHelpID
        ) {
            if (treeModel == null || nodeModel == null || tableModel == null ||

            }
            this.tableModel = tableModel;
            this.tableRendererModel = tableRendererModel;
            this.tablePropertyEditorsModel = tablePropertyEditorsModel;
            this.nodeActionsProvider = nodeActionsProvider;
            this.columnModels = columnModels.toArray (
                new ColumnModel [columnModels.size ()]

                return null;
            }
        }
        
        // TableHTMLModel

        @Override
        public boolean hasHTMLValueAt(Object node, String columnID) throws UnknownTypeException {
            return tableModel.hasHTMLValueAt(node, columnID);
        }

        @Override
        public String getHTMLValueAt(Object node, String columnID) throws UnknownTypeException {
            return tableModel.getHTMLValueAt(node, columnID);
        }
        
        // TablePropertyEditorsModel

        @Override
        public PropertyEditor getPropertyEditor(Object node, String columnID) throws UnknownTypeException {
            if (tablePropertyEditorsModel != null) {
                return tablePropertyEditorsModel.getPropertyEditor(node, columnID);
            } else {
                return null;
            }
        }
        
        

    }


        public List<AsynchronousModelFilter>   asynchModelFilters = Collections.emptyList();
        public List<TableRendererModel>        tableRendererModels = Collections.emptyList();
        public List<TableRendererModelFilter>  tableRendererModelFilters = Collections.emptyList();
        public List<TableHTMLModel>            tableHtmlModels = Collections.emptyList();
        public List<TableHTMLModelFilter>      tableHtmlModelFilters = Collections.emptyList();
        public List<TablePropertyEditorsModel> tablePropertyEditorsModels = Collections.emptyList();
        public List<TablePropertyEditorsModelFilter> tablePropertyEditorsModelFilters = Collections.emptyList();

        public void addOtherModels(List<? extends Model> otherModels) {
            Iterator it = otherModels.iterator ();

                        tableRendererModelFilters.add(0, (TableRendererModelFilter) model);
                    }
                }
                if (model instanceof TableHTMLModel && !tableHtmlModels.contains((TableHTMLModel) model)) {
                    tableHtmlModels = new ArrayList<TableHTMLModel>(tableHtmlModels);
                    tableHtmlModels.add((TableHTMLModel) model);
                }
                if (model instanceof TableHTMLModelFilter && !tableHtmlModelFilters.contains((TableHTMLModelFilter) model)) {
                    tableHtmlModelFilters = new ArrayList<TableHTMLModelFilter>(tableHtmlModelFilters);
                    if (first) {
                        tableHtmlModelFilters.add((TableHTMLModelFilter) model);
                    } else {
                        tableHtmlModelFilters.add(0, (TableHTMLModelFilter) model);
                    }
                }
                if (model instanceof TablePropertyEditorsModel && !tablePropertyEditorsModels.contains((TablePropertyEditorsModel) model)) {
                    tablePropertyEditorsModels = new ArrayList<TablePropertyEditorsModel>(tablePropertyEditorsModels);
                    tablePropertyEditorsModels.add((TablePropertyEditorsModel) model);
                }
                if (model instanceof TablePropertyEditorsModelFilter && !tablePropertyEditorsModelFilters.contains((TablePropertyEditorsModelFilter) model)) {
                    tablePropertyEditorsModelFilters = new ArrayList<TablePropertyEditorsModelFilter>(tablePropertyEditorsModelFilters);
                    if (first) {
                        tablePropertyEditorsModelFilters.add((TablePropertyEditorsModelFilter) model);
                    } else {
                        tablePropertyEditorsModelFilters.add(0, (TablePropertyEditorsModelFilter) model);
                    }
                }
                if (model instanceof NodeActionsProvider && !nodeActionsProviders.contains((NodeActionsProvider) model)) {
                    nodeActionsProviders = new ArrayList<NodeActionsProvider>(nodeActionsProviders);
                    nodeActionsProviders.add((NodeActionsProvider) model);




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2013 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common
 * Development and Distribution License("CDDL") (collectively, the
 * "License"). You may not use this file except in compliance with the
 * License. You can obtain a copy of the License at
 * http://www.netbeans.org/cddl-gplv2.html
 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
 * specific language governing permissions and limitations under the
 * License.  When distributing the software, include this License Header
 * Notice in each file and include the License file at
 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the GPL Version 2 section of the License file that
 * accompanied this code. If applicable, add the following below the
 * License Header, with the fields enclosed by brackets [] replaced by
 * your own identifying information:
 * "Portions Copyrighted [year] [name of copyright owner]"
 *
 * If you wish your version of this file to be governed by only the CDDL
 * or only the GPL Version 2, indicate your decision by adding
 * "[Contributor] elects to include this software in this distribution
 * under the [CDDL or GPL Version 2] license." If you do not indicate a
 * single choice of license, a recipient has the option to distribute
 * your version of this file under either the CDDL, the GPL Version 2 or
 * to extend the choice of license to its licensees as provided above.
 * However, if you add GPL Version 2 code and therefore, elected the GPL
 * Version 2 license, then the option applies only if the new code is
 * made subject to such option by the copyright holder.
 *
 * Contributor(s):
 *
 * Portions Copyrighted 2013 Sun Microsystems, Inc.
 */
package org.netbeans.spi.viewmodel;

/**
 * Use this to separate value and the HTML value.
 * When displaying a property value, then if the value is a String and if it contains
 * a HTML code, it's automatically rendered as HTML. The HTML code is then
 * stripped out to get the raw value.
 * If this is not desired or if it's necessary to provide a value and HTML code
 * that differs from each other, implement this model.
 * 
 * @author Martin Entlicher
 * @since 1.42
 * @see TableHTMLModelFilter
 */
public interface TableHTMLModel extends TableModel {
    
    /**
     * Test if the model has a HTML value.
     * For backward compatibility, if it returns <code>false</code>,
     * HTML value is is taken from the String value, if it contains some.
     * If this is not desired, return true here and null from
     * {@link #getHTMLValueAt(java.lang.Object, java.lang.String)}.
     * @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
     *             for this row
     * @param columnID an id of column defined by {@link ColumnModel#getID()}
     * @return <code>true</code> if there is some HTML value to be returned
     *         from {@link #getHTMLValueAt(java.lang.Object, java.lang.String)},
     *         <code>false</code> otherwise.
     *         When <code>false</code> is returned,
     *         {@link #getHTMLValueAt(java.lang.Object, java.lang.String)} is not called.
     * @throws UnknownTypeException if there is nothing to be provided for the given
     *         parameter type
     */
    boolean hasHTMLValueAt(Object node, String columnID) throws UnknownTypeException;
    
    /**
     * Get the HTML value.
     * 
     * @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
     *             for this row
     * @param columnID an id of column defined by {@link ColumnModel#getID()}
     * @return The HTML value, or <code>null</code> when no HTML value is provided.
     * @throws UnknownTypeException if there is nothing to be provided for the given
     *         parameter type
     * @see #hasHTMLValueAt(java.lang.Object, java.lang.String)
     */
    String getHTMLValueAt(Object node, String columnID) throws UnknownTypeException;

}




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2013 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common
 * Development and Distribution License("CDDL") (collectively, the
 * "License"). You may not use this file except in compliance with the
 * License. You can obtain a copy of the License at
 * http://www.netbeans.org/cddl-gplv2.html
 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
 * specific language governing permissions and limitations under the
 * License.  When distributing the software, include this License Header
 * Notice in each file and include the License file at
 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the GPL Version 2 section of the License file that
 * accompanied this code. If applicable, add the following below the
 * License Header, with the fields enclosed by brackets [] replaced by
 * your own identifying information:
 * "Portions Copyrighted [year] [name of copyright owner]"
 *
 * If you wish your version of this file to be governed by only the CDDL
 * or only the GPL Version 2, indicate your decision by adding
 * "[Contributor] elects to include this software in this distribution
 * under the [CDDL or GPL Version 2] license." If you do not indicate a
 * single choice of license, a recipient has the option to distribute
 * your version of this file under either the CDDL, the GPL Version 2 or
 * to extend the choice of license to its licensees as provided above.
 * However, if you add GPL Version 2 code and therefore, elected the GPL
 * Version 2 license, then the option applies only if the new code is
 * made subject to such option by the copyright holder.
 *
 * Contributor(s):
 *
 * Portions Copyrighted 2013 Sun Microsystems, Inc.
 */
package org.netbeans.spi.viewmodel;

/**
 * Use this to separate value and the HTML value.
 * Implement this filter to override the behavior of any registered {@link TableHTMLModel}s.
 * 
 * @author Martin Entlicher
 * @since 1.42
 * @see TableHTMLModel
 */
public interface TableHTMLModelFilter extends Model {
    
    /**
     * Test if the model has a HTML value.
     * For backward compatibility, if it returns <code>false</code>,
     * HTML value is is taken from the String value, if it contains some.
     * If this is not desired, return true here and null from
     * {@link #getHTMLValueAt(org.netbeans.spi.viewmodel.TableHTMLModel, java.lang.Object, java.lang.String)}.
     * @param original The original {@link TableHTMLModel}
     * @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
     *             for this row
     * @param columnID an id of column defined by {@link ColumnModel#getID()}
     * @return <code>true</code> if there is some HTML value to be returned
     *         from {@link #getHTMLValueAt(org.netbeans.spi.viewmodel.TableHTMLModel, java.lang.Object, java.lang.String)},
     *         <code>false</code> otherwise.
     *         When <code>false</code> is returned,
     *         {@link #getHTMLValueAt(org.netbeans.spi.viewmodel.TableHTMLModel, java.lang.Object, java.lang.String)}
     *         is not called.
     * @throws UnknownTypeException if there is nothing to be provided for the given
     *         parameter type
     */
    boolean hasHTMLValueAt(TableHTMLModel original, Object node, String columnID) throws UnknownTypeException;
    
    /**
     * Get the HTML value.
     * 
     * @param original The original {@link TableHTMLModel}
     * @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
     *             for this row
     * @param columnID an id of column defined by {@link ColumnModel#getID()}
     * @return The HTML value, or <code>null</code> when no HTML value is provided.
     * @throws UnknownTypeException if there is nothing to be provided for the given
     *         parameter type
     * @see #hasHTMLValueAt(org.netbeans.spi.viewmodel.TableHTMLModel, java.lang.Object, java.lang.String)
     */
    String getHTMLValueAt(TableHTMLModel original, Object node, String columnID) throws UnknownTypeException;
    
    /**
     * Registers given listener.
     *
     * @param l the listener to add
     */
    public abstract void addModelListener (ModelListener l);

    /**
     * Unregisters given listener.
     *
     * @param l the listener to remove
     */
    public abstract void removeModelListener (ModelListener l);
}




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2013 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common
 * Development and Distribution License("CDDL") (collectively, the
 * "License"). You may not use this file except in compliance with the
 * License. You can obtain a copy of the License at
 * http://www.netbeans.org/cddl-gplv2.html
 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
 * specific language governing permissions and limitations under the
 * License.  When distributing the software, include this License Header
 * Notice in each file and include the License file at
 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the GPL Version 2 section of the License file that
 * accompanied this code. If applicable, add the following below the
 * License Header, with the fields enclosed by brackets [] replaced by
 * your own identifying information:
 * "Portions Copyrighted [year] [name of copyright owner]"
 *
 * If you wish your version of this file to be governed by only the CDDL
 * or only the GPL Version 2, indicate your decision by adding
 * "[Contributor] elects to include this software in this distribution
 * under the [CDDL or GPL Version 2] license." If you do not indicate a
 * single choice of license, a recipient has the option to distribute
 * your version of this file under either the CDDL, the GPL Version 2 or
 * to extend the choice of license to its licensees as provided above.
 * However, if you add GPL Version 2 code and therefore, elected the GPL
 * Version 2 license, then the option applies only if the new code is
 * made subject to such option by the copyright holder.
 *
 * Contributor(s):
 *
 * Portions Copyrighted 2013 Sun Microsystems, Inc.
 */
package org.netbeans.spi.viewmodel;

import java.beans.PropertyEditor;

/**
 * Use this to provide different property editors for different table cells.
 * 
 * @author Martin Entlicher
 * @since 1.42
 * @see TablePropertyEditorsModelFilter
 */
public interface TablePropertyEditorsModel extends Model {
    
    /**
     * Get the property editor for the given table cell.
     * 
     * @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
     *             for this row
     * @param columnID an id of column defined by {@link ColumnModel#getID()}
     * @return The property editor or <code>null</code> to use the column default one.
     * @throws UnknownTypeException if there is nothing to be provided for the given
     *         parameter type
     */
    PropertyEditor getPropertyEditor(Object node, String columnID) throws UnknownTypeException;
    
}




/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2013 Oracle and/or its affiliates. All rights reserved.
 *
 * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
 * Other names may be trademarks of their respective owners.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common
 * Development and Distribution License("CDDL") (collectively, the
 * "License"). You may not use this file except in compliance with the
 * License. You can obtain a copy of the License at
 * http://www.netbeans.org/cddl-gplv2.html
 * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
 * specific language governing permissions and limitations under the
 * License.  When distributing the software, include this License Header
 * Notice in each file and include the License file at
 * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the GPL Version 2 section of the License file that
 * accompanied this code. If applicable, add the following below the
 * License Header, with the fields enclosed by brackets [] replaced by
 * your own identifying information:
 * "Portions Copyrighted [year] [name of copyright owner]"
 *
 * If you wish your version of this file to be governed by only the CDDL
 * or only the GPL Version 2, indicate your decision by adding
 * "[Contributor] elects to include this software in this distribution
 * under the [CDDL or GPL Version 2] license." If you do not indicate a
 * single choice of license, a recipient has the option to distribute
 * your version of this file under either the CDDL, the GPL Version 2 or
 * to extend the choice of license to its licensees as provided above.
 * However, if you add GPL Version 2 code and therefore, elected the GPL
 * Version 2 license, then the option applies only if the new code is
 * made subject to such option by the copyright holder.
 *
 * Contributor(s):
 *
 * Portions Copyrighted 2013 Sun Microsystems, Inc.
 */
package org.netbeans.spi.viewmodel;

import java.beans.PropertyEditor;

/**
 * Use this to provide different property editors for different table cells.
 * Implement this filter to override the behavior of any registered {@link TablePropertyEditorsModel}s.
 *
 * @author Martin Entlicher
 * @since 1.42
 * @see TablePropertyEditorsModel
 */
public interface TablePropertyEditorsModelFilter extends Model {
    
    /**
     * Get the property editor for the given table cell.
     * 
     * @param original The original {@link TablePropertyEditorsModel}
     * @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
     *             for this row
     * @param columnID an id of column defined by {@link ColumnModel#getID()}
     * @return The property editor or <code>null</code> to use the column default one.
     * @throws UnknownTypeException if there is nothing to be provided for the given
     *         parameter type
     */
    PropertyEditor getPropertyEditor(TablePropertyEditorsModel original,
                                     Object node, String columnID) throws UnknownTypeException;
    
}

Return to bug 228909

Lines 399-404 Link Here

(-)a/spi.viewmodel/apichanges.xml (+33 lines)
399	<class package="org.netbeans.spi.viewmodel" name="TableRendererModelFilter" />	399	<class package="org.netbeans.spi.viewmodel" name="TableRendererModelFilter" />
400	<issue number="186672"/>	400	<issue number="186672"/>
401	</change>	401	</change>
		402	<change>
		403	<api name="ViewModelAPI"/>
		404	<summary>Separate the value and HTML value and allow custom property editors.</summary>
		405	<version major="1" minor="42"/>
		406	<date day="30" month="4" year="2013"/>
		407	<author login="mentlicher"/>
		408	<compatibility binary="compatible" source="compatible" deletion="no" addition="yes" modification="no"/>
		409	<description>
		410	So far the HTML value is automatically retrieved from the value provided
		411	by the <code>TableModel</code> when the value is a <code>String</code>
		412	and contains HTML code. This is not flexible enough and therefore
		413	we separate the value and HTML value by introduction of <code>TableHTMLModel</code>
		414	and <code>TableHTMLModelFilter</code>.<br/>
		415	In addition to that, this API change also brings a prossibility
		416	to provide custom property editor, separately for every value.
		417	Two interfaces are introduced for this purpose: <code>TablePropertyEditorsModel</code>
		418	and <code>TablePropertyEditorsModelFilter</code>.<br/>
		419	This also implies, that <code>Models.CompoundModel</code> now implements
		420	<code>TableHTMLModel</code> and <code>TablePropertyEditorsModel</code>.<br/>
		421	In order to be able to fire changes in HTML value and also in r/w state,
		422	an additional constructor of <code>ModelEvent.TableValueChanged</code>
		423	is added, which takes the change mask. Three change masks are defined:
		424	<code>VALUE_MASK</code>, <code>HTML_VALUE_MASK</code> and <code>IS_READ_ONLY_MASK</code>.
		425	To get the change mask, <code>ModelEvent.TableValueChanged.getChange()</code>
		426	method is added.
		427	</description>
		428	<class package="org.netbeans.spi.viewmodel" name="TableHTMLModel" />
		429	<class package="org.netbeans.spi.viewmodel" name="TableHTMLModelFilter" />
		430	<class package="org.netbeans.spi.viewmodel" name="TablePropertyEditorsModel" />
		431	<class package="org.netbeans.spi.viewmodel" name="TablePropertyEditorsModelFilter" />
		432	<class package="org.netbeans.spi.viewmodel" name="ModelEvent" />
		433	<issue number="228909"/>
		434	</change>
402		435
403		436
404	</changes>	437	</changes>

Lines 87-94 Link Here

(-)a/spi.viewmodel/src/org/netbeans/spi/viewmodel/ModelEvent.java (+46 lines)
87	*/	87	*/
88	public static class TableValueChanged extends ModelEvent {	88	public static class TableValueChanged extends ModelEvent {
89		89
		90	/**
		91	* The mask for value change.
		92	* @since 1.42
		93	*/
		94	public static final int VALUE_MASK = 1;
		95	/**
		96	* The mask for HTML value change.
		97	* @since 1.42
		98	*/
		99	public static final int HTML_VALUE_MASK = 2;
		100	/**
		101	* The mask for change of the read only state.
		102	* @since 1.42
		103	*/
		104	public static final int IS_READ_ONLY_MASK = 4;
		105
90	private Object node;	106	private Object node;
91	private String columnID;	107	private String columnID;
		108	private int change;
92		109
93	/**	110	/**
94	* Creates a new instance of TableValueChanged event.	111	* Creates a new instance of TableValueChanged event.
Lines 104-112 Link Here
104	Object node,	121	Object node,
105	String columnID	122	String columnID
106	) {	123	) {
		124	this(source, node, columnID, 0xffffffff);
		125	}
		126
		127	/**
		128	* Creates a new instance of TableValueChanged event.
		129	*
		130	* @param source a source if event.
		131	* @param node a changed node instance
		132	* @param columnID a changed column name
		133	* @param change one of the *_MASK constants or their aggregation.
		134	* @since 1.42
		135	*/
		136	public TableValueChanged (
		137	Object source,
		138	Object node,
		139	String columnID,
		140	int change
		141	) {
107	super (source);	142	super (source);
108	this.node = node;	143	this.node = node;
109	this.columnID = columnID;	144	this.columnID = columnID;
		145	this.change = change;
110	}	146	}
111		147
112	/**	148	/**
Lines 130-135 Link Here
130	public String getColumnID () {	166	public String getColumnID () {
131	return columnID;	167	return columnID;
132	}	168	}
		169
		170	/**
		171	* Get the change mask.
		172	*
		173	* @return the change mask, one of the *_MASK constants or their aggregation.
		174	* @since 1.42
		175	*/
		176	public int getChange() {
		177	return change;
		178	}
133	}	179	}
134		180
135	/**	181	/**

Line 0 Link Here

(-)a/spi.viewmodel/src/org/netbeans/spi/viewmodel/TableHTMLModel.java (+90 lines)
		1	/*
		2	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
		3	*
		4	* Copyright 2013 Oracle and/or its affiliates. All rights reserved.
		5	*
		6	* Oracle and Java are registered trademarks of Oracle and/or its affiliates.
		7	* Other names may be trademarks of their respective owners.
		8	*
		9	* The contents of this file are subject to the terms of either the GNU
		10	* General Public License Version 2 only ("GPL") or the Common
		11	* Development and Distribution License("CDDL") (collectively, the
		12	* "License"). You may not use this file except in compliance with the
		13	* License. You can obtain a copy of the License at
		14	* http://www.netbeans.org/cddl-gplv2.html
		15	* or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
		16	* specific language governing permissions and limitations under the
		17	* License. When distributing the software, include this License Header
		18	* Notice in each file and include the License file at
		19	* nbbuild/licenses/CDDL-GPL-2-CP. Oracle designates this
		20	* particular file as subject to the "Classpath" exception as provided
		21	* by Oracle in the GPL Version 2 section of the License file that
		22	* accompanied this code. If applicable, add the following below the
		23	* License Header, with the fields enclosed by brackets [] replaced by
		24	* your own identifying information:
		25	* "Portions Copyrighted [year] [name of copyright owner]"
		26	*
		27	* If you wish your version of this file to be governed by only the CDDL
		28	* or only the GPL Version 2, indicate your decision by adding
		29	* "[Contributor] elects to include this software in this distribution
		30	* under the [CDDL or GPL Version 2] license." If you do not indicate a
		31	* single choice of license, a recipient has the option to distribute
		32	* your version of this file under either the CDDL, the GPL Version 2 or
		33	* to extend the choice of license to its licensees as provided above.
		34	* However, if you add GPL Version 2 code and therefore, elected the GPL
		35	* Version 2 license, then the option applies only if the new code is
		36	* made subject to such option by the copyright holder.
		37	*
		38	* Contributor(s):
		39	*
		40	* Portions Copyrighted 2013 Sun Microsystems, Inc.
		41	*/
		42	package org.netbeans.spi.viewmodel;
		43
		44	/**
		45	* Use this to separate value and the HTML value.
		46	* When displaying a property value, then if the value is a String and if it contains
		47	* a HTML code, it's automatically rendered as HTML. The HTML code is then
		48	* stripped out to get the raw value.
		49	* If this is not desired or if it's necessary to provide a value and HTML code
		50	* that differs from each other, implement this model.
		51	*
		52	* @author Martin Entlicher
		53	* @since 1.42
		54	* @see TableHTMLModelFilter
		55	*/
		56	public interface TableHTMLModel extends TableModel {
		57
		58	/**
		59	* Test if the model has a HTML value.
		60	* For backward compatibility, if it returns <code>false</code>,
		61	* HTML value is is taken from the String value, if it contains some.
		62	* If this is not desired, return true here and null from
		63	* {@link #getHTMLValueAt(java.lang.Object, java.lang.String)}.
		64	* @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
65	* for this row
66	* @param columnID an id of column defined by {@link ColumnModel#getID()}
67	* @return <code>true</code> if there is some HTML value to be returned
68	* from {@link #getHTMLValueAt(java.lang.Object, java.lang.String)},
69	* <code>false</code> otherwise.
70	* When <code>false</code> is returned,
71	* {@link #getHTMLValueAt(java.lang.Object, java.lang.String)} is not called.
72	* @throws UnknownTypeException if there is nothing to be provided for the given
73	* parameter type
74	*/
75	boolean hasHTMLValueAt(Object node, String columnID) throws UnknownTypeException;
76
77	/**
78	* Get the HTML value.
79	*
80	* @param node an object returned from {@link TreeModel#getChildren(java.lang.Object, int, int) }
81	* for this row
82	* @param columnID an id of column defined by {@link ColumnModel#getID()}
83	* @return The HTML value, or <code>null</code> when no HTML value is provided.
84	* @throws UnknownTypeException if there is nothing to be provided for the given
85	* parameter type
86	* @see #hasHTMLValueAt(java.lang.Object, java.lang.String)
87	*/
88	String getHTMLValueAt(Object node, String columnID) throws UnknownTypeException;
89
90	}