[SAGA-RG] saga-ogf SVN commit 1289: /trunk/documents/saga-core-binding-java/implementation/VU/

[ceriel at cs.vu.nl]

User: svn_ceriel
Date: 2010/10/04 02:36 PM

Modified:
 /trunk/documents/saga-core-binding-java/implementation/VU/
  CHANGES.txt, INSTALL.txt, LICENSE.txt, README.txt, build.xml

Log:
 Some preparations for release

File Changes:

Directory: /trunk/documents/saga-core-binding-java/implementation/VU/
=====================================================================

File [modified]: CHANGES.txt
Delta lines: +45 -0
===================================================================
--- trunk/documents/saga-core-binding-java/implementation/VU/CHANGES.txt	2010-10-04 19:32:14 UTC (rev 1288)
+++ trunk/documents/saga-core-binding-java/implementation/VU/CHANGES.txt	2010-10-04 19:35:43 UTC (rev 1289)
@@ -1,3 +1,48 @@
+Most of the additions and fixes in release 1.1 are prompted by the
+recent changes in the SAGA specifications.
+
+Additions and fixes in release 1.1 with respect to release 1.0.1:
+- Buffer factory method no longer throws NotImplementedException.
+- Buffer methods no longer throw NotImplementedException.
+- Context factory method no longer throws NotImplementedException.
+- Context setDefault() method no longer exists. Instead, an implementation
+  can add default values for attributes when a context is added to a session.
+- IOVec factory method no longer throws NotImplementedException.
+- a JobDescription has two new attributes: WALLTIMELIMIT and JOBPROJECT.
+- the JobService create method now may throw a BadParameterException.
+- a Job now has a new attribute: SERVICEURL.
+- the READ and WRITE flags are moved to the namespace package.
+- NSDirectory now has a method getMTime(URL) that returns the last modification
+  time of the specified entry, and also a task version of same.
+- NSEntry now has a method getMTime() that returns the last modification time
+  of the entry at hand, and also a task version of same.
+- the NSEntry.link(URL) method can now throw DoesNotExistException.
+- NSEntry.close() no longer throws IncorrectStateException.
+- various namespace methods now have READ as default flag instead of NONE.
+- Session constructor methods can no longer throw NotImplementedException.
+- Session.addContext() can no longer throw NotImplementedException.
+- Session.removeContext() can no longer throw NotImplementedException.
+- Session.listContexts() can no longer throw NotImplementedException.
+- Session.close() can no longer throw NotImplementedException.
+- TASKCONTAINER_STATE attribute is now of type String and indicates a
+  Saga Object ID instead of a handle or cookie.
+- TaskContainer.add(Task t) now does not return a cookie anymore.
+- TaskContainer.remove() now takes a task instead of a cookie as parameter.
+- TaskContainer now has a version of "waitFor" with a timeout.
+- TaskContainer.getTask() now takes a string (object id) instead of an int
+  (cookie).
+- TaskContainer.listTasks() is removed, as we already have getTasks().
+- Task.getResult() now can throw any Saga exception. It returns the result of
+  the method executed, including its exceptions.
+- URL factory methods can no longer throw NotImplementedException.
+- URL now has a method getEscaped() which returns the URL as a string, with
+  escapes added where needed to parse the result as an URL.
+- URL now has default parameters for various set... methods.
+- StreamService has been renamed StreamServer. A StreamServer object now
+  can also represent a remote server. It also has a connect() method now.
+- Stream.connect() now also has a variant with a timeout.
+- Stream.close() can no longer throw IncorrectState.
+
 Additions and fixes in release 1.0.1 with respect to release 1.0:
 
 - a simple nested-exception mechanism has been added to

File [modified]: INSTALL.txt
Delta lines: +2 -4
===================================================================
--- trunk/documents/saga-core-binding-java/implementation/VU/INSTALL.txt	2010-10-04 19:32:14 UTC (rev 1288)
+++ trunk/documents/saga-core-binding-java/implementation/VU/INSTALL.txt	2010-10-04 19:35:43 UTC (rev 1289)
@@ -2,9 +2,7 @@
 
   To install, you need a Java 1.5 or newer and you need "ant".
   Just call "ant" to install. This will create a
-  "lib" directory with saga-api-1.0.1.jar in it, and a
+  "lib" directory with saga-api-1.1.jar in it, and a
   "doc" directory containing the javadoc of the SAGA api.
 
-  A binary release can be created by calling "ant zip". For that,
-  you probably need to be on a Unix machine, and have "make" and
-  a Latex installation.
+  A binary release can be created by calling "ant zip".
\ No newline at end of file

File [modified]: LICENSE.txt
Delta lines: +1 -1
===================================================================
--- trunk/documents/saga-core-binding-java/implementation/VU/LICENSE.txt	2010-10-04 19:32:14 UTC (rev 1288)
+++ trunk/documents/saga-core-binding-java/implementation/VU/LICENSE.txt	2010-10-04 19:35:43 UTC (rev 1289)
@@ -1,4 +1,4 @@
-Copyright (c) 2008, 2009 Vrije Universiteit, The Netherlands. All rights reserved.
+Copyright (c) 2008, 2009, 2010 Vrije Universiteit, The Netherlands. All rights reserved.
 
 Redistribution and use in source and binary forms,
 with or without modification, are permitted provided

File [modified]: README.txt
Delta lines: +5 -6
===================================================================
--- trunk/documents/saga-core-binding-java/implementation/VU/README.txt	2010-10-04 19:32:14 UTC (rev 1288)
+++ trunk/documents/saga-core-binding-java/implementation/VU/README.txt	2010-10-04 19:35:43 UTC (rev 1289)
@@ -1,10 +1,9 @@
-The SAGA Java language bindings, release 1.0.1.
+The SAGA Java language bindings, release 1.1.
 
-This is release 1.0.1 of the SAGA Java language bindings.
-The differences between this version and release 1.0 are described
-in the file CHANGES.txt. The release has version number 1.0.1
-and not 1.1, because it still follows version 1.0 of the SAGA
-specifications.
+This is release 1.1 of the SAGA Java language bindings.
+The differences between this version and release 1.0.1 are described
+in the file CHANGES.txt. The release has version number 1.1, as
+it follows version 1.1 of the SAGA specifications.
 
 This package does not enable you to run SAGA applications, but
 it DOES allow you to write and compile SAGA applications. It

File [modified]: build.xml
Delta lines: +4 -12
===================================================================
--- trunk/documents/saga-core-binding-java/implementation/VU/build.xml	2010-10-04 19:32:14 UTC (rev 1288)
+++ trunk/documents/saga-core-binding-java/implementation/VU/build.xml	2010-10-04 19:35:43 UTC (rev 1289)
@@ -6,9 +6,9 @@
 
     <!-- Global properties -->
 
-    <property name="version" value="-1.0.1" />
+    <property name="version" value="-1.1" />
 
-    <property name="src" location="." />
+    <property name="src" location="src" />
     <property name="tmp" location="tmp" />
     <property name="lib" location="lib" />
     <property name="doc" location="doc" />
@@ -59,20 +59,13 @@
 		<copy todir="${prefix}/lib" file="${jar}" />
 	</target>
 
-    <target name="pdf" depends="init"
-	description="build the Java language bindings PDF">
-	<ant dir="gfd" target="build"/>
-	<copy file="gfd/SAGA_CORE_JAVA_BINDING.pdf" todir="${doc}"/>
-	<ant dir="gfd" target="clean"/>
-    </target>
-
     <target name="javadoc"
 	depends="compile"
 	description="generate all javadocs">
 	<javadoc destdir="${doc}/saga-api${version}"
 	    access="public"
 	    packagenames="org.ogf.saga,org.ogf.saga.*"
-	    overview="overview.html"
+	    overview="${src}/overview.html"
 	    doctitle="SAGA Java language bindings, version${version}"
 	    bottom="The SAGA Java language bindings, version${version}"
 	    windowtitle="SAGA Java language bindings, version${version}"
@@ -94,11 +87,10 @@
 	depends="clean"
 	description="clean up, including docs">
 	<delete dir="${doc}" />
-	<ant dir="gfd" target="distclean"/>
 	<delete file="saga-api${version}.zip" />
     </target>
 
-    <target name="zip" depends="build, javadoc, pdf">
+    <target name="zip" depends="build, javadoc">
         <delete file="saga-api${version}-binary.zip" />
         <delete file="${sources-filename}.zip" />
         <delete dir="sources" />