Update of /var/cvs/src/org/mmbase/bridge/util
In directory james.mmbase.org:/tmp/cvs-serv22165
Modified Files:
AbstractCollectionNodeList.java AbstractNodeManager.java
CollectionRelationList.java DataTypeField.java MapNode.java
NodeChanger.java NodeMap.java
Log Message:
javadoc
See also: http://cvs.mmbase.org/viewcvs/src/org/mmbase/bridge/util
Index: AbstractCollectionNodeList.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/AbstractCollectionNodeList.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- AbstractCollectionNodeList.java 1 Aug 2008 13:12:13 -0000 1.6
+++ AbstractCollectionNodeList.java 4 Sep 2008 06:54:27 -0000 1.7
@@ -17,6 +17,16 @@
import org.mmbase.util.logging.Logger;
import org.mmbase.util.logging.Logging;
+/**
+ * An AbstractCollectionNodeList implements a [EMAIL PROTECTED]
org.mmbase.bridge BridgeList} of [EMAIL PROTECTED]
+ * org.mmbase.bridge.Node}s, based on a collection of objects of perhaps other
type, which are
+ * implicitely [EMAIL PROTECTED] #convert}ed when necessary.
+ *
+ * @since MMBase-1.8
+ * @version $Id: AbstractCollectionNodeList.java,v 1.7 2008/09/04 06:54:27
michiel Exp $
+ * @author Nico Klasens
+ */
+
public abstract class AbstractCollectionNodeList<E extends Node> extends
AbstractBridgeList<E> {
private static final Logger log =
Logging.getLoggerInstance(AbstractCollectionNodeList.class);
Index: AbstractNodeManager.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/AbstractNodeManager.java,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -b -r1.9 -r1.10
--- AbstractNodeManager.java 3 Feb 2008 17:33:56 -0000 1.9
+++ AbstractNodeManager.java 4 Sep 2008 06:54:27 -0000 1.10
@@ -21,10 +21,10 @@
/**
* Abstract implementation of NodeManager, to minimalize the implementation of
a virtual one. Must
* methods throw UnsupportOperationException (like in [EMAIL PROTECTED]
- * org.mmbase.bridge.implementation.VirtualNodeManager}.
+ * org.mmbase.bridge.implementation.VirtualNodeManager}).
*
* @author Michiel Meeuwissen
- * @version $Id: AbstractNodeManager.java,v 1.9 2008/02/03 17:33:56 nklasens
Exp $
+ * @version $Id: AbstractNodeManager.java,v 1.10 2008/09/04 06:54:27 michiel
Exp $
* @see org.mmbase.bridge.NodeManager
* @since MMBase-1.8
*/
Index: CollectionRelationList.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/CollectionRelationList.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- CollectionRelationList.java 16 Feb 2007 20:07:24 -0000 1.6
+++ CollectionRelationList.java 4 Sep 2008 06:54:27 -0000 1.7
@@ -16,10 +16,10 @@
import org.mmbase.util.logging.*;
/**
- * A list of nodes, based on a Collection of Nodes
+ * A list of [EMAIL PROTECTED] org.mmbase.Relation}s, based on a Collection of
Nodes
*
* @author Michiel Meeuwissen
- * @version $Id: CollectionRelationList.java,v 1.6 2007/02/16 20:07:24 michiel
Exp $
+ * @version $Id: CollectionRelationList.java,v 1.7 2008/09/04 06:54:27 michiel
Exp $
* @since MMBase-1.8
*/
public class CollectionRelationList extends
AbstractCollectionNodeList<Relation> implements RelationList {
@@ -27,12 +27,12 @@
private static final Logger log =
Logging.getLoggerInstance(CollectionRelationList.class);
- public CollectionRelationList(Collection c, NodeManager nodeManager) {
+ public CollectionRelationList(Collection<? extends Node> c, NodeManager
nodeManager) {
super(c, nodeManager);
}
- public CollectionRelationList(Collection c, Cloud cloud) {
+ public CollectionRelationList(Collection<? extends Node> c, Cloud cloud) {
super(c, cloud);
}
Index: DataTypeField.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/DataTypeField.java,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -b -r1.8 -r1.9
--- DataTypeField.java 1 Sep 2008 17:00:52 -0000 1.8
+++ DataTypeField.java 4 Sep 2008 06:54:27 -0000 1.9
@@ -18,11 +18,16 @@
/**
- * Wraps a DataType object into a (virtual) Field object, with a Virtual
NodeManager with only one field
- * (itself). This also associates a Cloud object with the DataType.
+ * Wraps a DataType object into a (virtual) Field object. It can be
instantiated with [EMAIL PROTECTED]
+ * #DataTypeField(Cloud, DataType)} to have a 'virtual field with a Virtual
NodeManager with only one field
+ * (itself). The constructor [EMAIL PROTECTED] DataTypeField(Field,
DataType)}, produces a new field object,
+ * that is very similar to the one wrapped, only with a different [EMAIL
PROTECTED] DataType}.
+ *
+ * This also a way to associate a Cloud object with a DataType (it is actually
possible to see that
+ * as the essence of being a [EMAIL PROTECTED] org.mmbase.bridge.Field}).
*
* @author Michiel Meeuwissen
- * @version $Id: DataTypeField.java,v 1.8 2008/09/01 17:00:52 michiel Exp $
+ * @version $Id: DataTypeField.java,v 1.9 2008/09/04 06:54:27 michiel Exp $
* @since MMBase-1.8.7
*/
Index: MapNode.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/MapNode.java,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -b -r1.11 -r1.12
--- MapNode.java 3 Feb 2008 17:33:56 -0000 1.11
+++ MapNode.java 4 Sep 2008 06:54:27 -0000 1.12
@@ -16,11 +16,12 @@
import org.mmbase.util.functions.*;
/**
- * A bridge Node based on a Map. It can come in handy sometimes to be able to
present any Map as an
- * MMBase Node. E.g. because then it can be accessed in MMBase taglib using
mm:field tags.
+ * A bridge Node based on a [EMAIL PROTECTED] It can come in handy sometimes
to be able to present any [EMAIL PROTECTED]
+ * java.util.Map} as an MMBase Node. E.g. because then it can be accessed in
MMBase taglib using
+ * mm:field tags. Don't confuse this with [EMAIL PROTECTED] NodeMap}.
* @author Michiel Meeuwissen
- * @version $Id: MapNode.java,v 1.11 2008/02/03 17:33:56 nklasens Exp $
+ * @version $Id: MapNode.java,v 1.12 2008/09/04 06:54:27 michiel Exp $
* @since MMBase-1.8
*/
Index: NodeChanger.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/NodeChanger.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- NodeChanger.java 10 Feb 2007 15:47:42 -0000 1.3
+++ NodeChanger.java 4 Sep 2008 06:54:27 -0000 1.4
@@ -14,10 +14,13 @@
import org.mmbase.bridge.*;
/**
- * Wraps another Node, and adds 'isChangedByThis'.
+ * Wraps another Node, and adds '[EMAIL PROTECTED] #isChangedByThis}'.
+ *
+ * Before commiting the node, you may want to check if <em>you</em> changed to
node, and not some
+ * other thread. In that case you can first wrap your Node in a NodeChanger
object.
*
* @author Michiel Meeuwissen
- * @version $Id: NodeChanger.java,v 1.3 2007/02/10 15:47:42 nklasens Exp $
+ * @version $Id: NodeChanger.java,v 1.4 2008/09/04 06:54:27 michiel Exp $
* @since MMBase-1.8
*/
@@ -63,11 +66,10 @@
public void setDateValue(String fieldName, Date value) {
change(fieldName); super.setDateValue(fieldName, value); }
@Override
public void setListValue(String fieldName, List value) {
change(fieldName); super.setListValue(fieldName, value); }
+
/**
- * The isChanged method reflects the isChanged status of the underlying
core node.isChanged. Before
- * commiting the node, you may want to check if _you_ changed to node, and
not some other
- * thread. In that case you can first wrap your Node in a NodeChanger
object.
- *
+ * The [EMAIL PROTECTED] #isChanged} method reflects the isChanged status
of the underlying core node.isChanged,
+ * this one does that too, but only return true, if this instance
performed this change.
*/
public boolean isChangedByThis() {
return originalValues != null && super.isChanged();
Index: NodeMap.java
===================================================================
RCS file: /var/cvs/src/org/mmbase/bridge/util/NodeMap.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- NodeMap.java 11 Feb 2007 20:05:50 -0000 1.4
+++ NodeMap.java 4 Sep 2008 06:54:27 -0000 1.5
@@ -15,13 +15,13 @@
import org.mmbase.bridge.*;
/**
- * A Map representing a Node. This class can be used if you need a bridge Node
object to look like a
- * Map (where the keys are the fields).
+ * A [EMAIL PROTECTED] java.util.Map} representing a Node. This class can be
used if you need a bridge [EMAIL PROTECTED] object to look like a
+ * [EMAIL PROTECTED] java.util.Map} (where the keys are the fields). Don't
confuse this with [EMAIL PROTECTED] MapNode}.
*
* This object is also still a Node object.
*
* @author Michiel Meeuwissen
- * @version $Id: NodeMap.java,v 1.4 2007/02/11 20:05:50 nklasens Exp $
+ * @version $Id: NodeMap.java,v 1.5 2008/09/04 06:54:27 michiel Exp $
* @since MMBase-1.8
*/
_______________________________________________
Cvs mailing list
[email protected]
http://lists.mmbase.org/mailman/listinfo/cvs
