[Tm4j-commits] tm4j/src/org/tm4j/topicmap/tmdm Occurrence.java, 1.3, 1.4

[Xuan B. <med...@us...>]

Update of /cvsroot/tm4j/tm4j/src/org/tm4j/topicmap/tmdm
In directory sc8-pr-cvs10.sourceforge.net:/tmp/cvs-serv27283/src/org/tm4j/topicmap/tmdm

Modified Files:
	Occurrence.java 
Log Message:
Clarify that TMAPI 1.0 is too incompatible to TMDM such that it is not possible to support TMAPI 1.0 fully in the Occurence class.

Index: Occurrence.java
===================================================================
RCS file: /cvsroot/tm4j/tm4j/src/org/tm4j/topicmap/tmdm/Occurrence.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** Occurrence.java	23 Jan 2008 00:11:14 -0000	1.3
--- Occurrence.java	23 Jan 2008 18:59:18 -0000	1.4
***************
*** 7,10 ****
--- 7,16 ----
  
  /**
+ 
+ 	We do <b>not</b> support TMAPI setValue(), getValue(),
+ 	because the TMAPI setValue(), getValue() methods have different semantics (they not only set the TMDM value but also the TMDM datatype, whereas a TMDM setValue sets only the TMDM value and leaves the TMDM datatyoe untouched).
+ 	
+ 	Likewise, we do not support setResource(), getResource(). 
+ 
  	@author <a href="mailto:xua...@pu...">Xuân Baldauf</a>
  */
***************
*** 26,37 ****
  	
  	@TMDM
- 	@TMAPI
  	public void setValue(String value);
  	
  	@TMDM
- 	@TMAPI
  	public String getValue();
  	
  	/**
  		FIXME: it is unclear whether we should expose this method in this interface.
  	*/
--- 32,48 ----
  	
  	@TMDM
  	public void setValue(String value);
  	
  	@TMDM
  	public String getValue();
  	
  	/**
+ 		Provide a shortcut to change the datatype and the value in one transaction.
+ 		This is to avoid cases where value unintentionally does not match the datatype
+ 		for a very brief time.
+ 	*/
+ 	public String setDatatypeAndValue(Locator datatype,String value);
+ 	
+ 	/**
  		FIXME: it is unclear whether we should expose this method in this interface.
  	*/