User: svn_ceriel Date: 2010/09/22 10:28 AM Modified: /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/error/ package.html /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/ NSDirectory.java, NSEntry.java, NSFactory.java /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/session/ Session.java, SessionFactory.java /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/task/ TaskContainer.java Log: A couple of modifications to make the Java language bindings more conforming to the latest Saga specs: - fixed signature of task_container.remove() (does not return anything now); - various namespaces constructors now take READ as default flag; - added the various versions of get_mtime(); - fixed signature of session constructors: no longer throws NotImplemented. File Changes: Directory: /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/error/ ============================================================================================ File [modified]: package.html Delta lines: +6 -0 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/error/package.html 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/error/package.html 2010-09-22 15:28:13 UTC (rev 1285) @@ -52,6 +52,12 @@ </p> <p> +The IncorrectType exception as described in the language-independent +SAGA specification does not exist in the Java Language Bindings for SAGA, +as Java has a ClassCastException for that purpose. +</p> + +<p> A simple mechanism exists for storing and examining exceptions that may be thrown by adaptors in adaptor-based Saga implementations. In such implementations, the top-level exception (the one highest up in the Saga exception hierarchy) is not Directory: /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/ ================================================================================================ File [modified]: NSDirectory.java Delta lines: +64 -0 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/NSDirectory.java 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/NSDirectory.java 2010-09-22 15:28:13 UTC (rev 1285) @@ -392,6 +392,54 @@ NoSuccessException; /** + * Returns the time of the last modification in seconds since epoch + * (01.01.1970) of the specified name. + * + * @param name + * the name of which the last modification time must be returned. + * @return + * the last modification time. + * @exception NotImplementedException + * is thrown if the implementation does not provide an + * implementation of this method. + * @exception PermissionDeniedException + * is thrown when the method failed because the identity used did + * not have sufficient permissions to perform the operation + * successfully. + * @exception AuthorizationFailedException + * is thrown when none of the available contexts of the + * used session could be used for successful authorization. + * This error indicates that the resource could not be accessed + * at all, and not that an operation was not available due to + * restricted permissions. + * @exception AuthenticationFailedException + * is thrown when operation failed because none of the available + * session contexts could successfully be used for authentication. + * @exception TimeoutException + * is thrown when a remote operation did not complete successfully + * because the network communication or the remote service timed + * out. + * @exception BadParameterException + * is thrown when the specified URL contains an invalid entry name. + * @exception IncorrectStateException + * is thrown when the NSDirectory is already closed. + * @exception IncorrectURLException + * is thrown when an implementation cannot handle the specified + * protocol, or that access to the specified entity via the + * given protocol is impossible. + * @exception DoesNotExistException + * is thrown if the specified name does not exist. + * @exception NoSuccessException + * is thrown when the operation was not successfully performed, + * and none of the other exceptions apply. + */ + public long getMTime(URL name) throws NotImplementedException, + IncorrectURLException, DoesNotExistException, AuthenticationFailedException, + AuthorizationFailedException, PermissionDeniedException, + BadParameterException, IncorrectStateException, TimeoutException, + NoSuccessException; + + /** * Tests the name for being a directory. * * @param name @@ -2367,6 +2415,22 @@ */ public Task<NSDirectory, Boolean> isLink(TaskMode mode, URL name) throws NotImplementedException; + + /** + * Creates a task that determines the last modification time of + * the specified name. + * + * @param mode + * the task mode. + * @param name + * of which the last modification time must be determined. + * @return the task. + * @exception NotImplementedException + * is thrown when the task version of this method is not + * implemented. + */ + public Task<NSDirectory, Long> getMTime(TaskMode mode, URL name) + throws NotImplementedException; /** * Creates a task that returns the URL representing the link target. File [modified]: NSEntry.java Delta lines: +50 -0 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/NSEntry.java 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/NSEntry.java 2010-09-22 15:28:13 UTC (rev 1285) @@ -234,6 +234,43 @@ TimeoutException, NoSuccessException; /** + * Returns the time of the last modification in seconds since epoch + * (01.01.1970). + * + * @return + * the last modification time. + * @exception NotImplementedException + * is thrown if the implementation does not provide an + * implementation of this method. + * @exception PermissionDeniedException + * is thrown when the method failed because the identity used did + * not have sufficient permissions to perform the operation + * successfully. + * @exception AuthorizationFailedException + * is thrown when none of the available contexts of the + * used session could be used for successful authorization. + * This error indicates that the resource could not be accessed + * at all, and not that an operation was not available due to + * restricted permissions. + * @exception AuthenticationFailedException + * is thrown when operation failed because none of the available + * session contexts could successfully be used for authentication. + * @exception TimeoutException + * is thrown when a remote operation did not complete successfully + * because the network communication or the remote service timed + * out. + * @exception IncorrectStateException + * is thrown when the NSEntry is already closed. + * @exception NoSuccessException + * is thrown when the operation was not successfully performed, + * and none of the other exceptions apply. + */ + public long getMTime() throws NotImplementedException, + AuthenticationFailedException, AuthorizationFailedException, + PermissionDeniedException, IncorrectStateException, + TimeoutException, NoSuccessException; + + /** * Copies this entry to another part of the namespace. * * @param target @@ -787,6 +824,19 @@ throws NotImplementedException; /** + * Creates a task that returns the last modification time of this entry. + * + * @param mode + * the task mode. + * @return the task. + * @exception NotImplementedException + * is thrown when the task version of this method is not + * implemented. + */ + public Task<NSEntry, Long> getMTime(TaskMode mode) + throws NotImplementedException; + + /** * Creates a task that tests this entry for being a directory. * * @param mode File [modified]: NSFactory.java Delta lines: +12 -12 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/NSFactory.java 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/namespace/NSFactory.java 2010-09-22 15:28:13 UTC (rev 1285) @@ -218,7 +218,7 @@ DoesNotExistException, AlreadyExistsException, TimeoutException, NoSuccessException { initializeFactory(); - return factory.doCreateNSEntry(session, name, Flags.NONE.getValue()); + return factory.doCreateNSEntry(session, name, Flags.READ.getValue()); } /** @@ -328,7 +328,7 @@ NoSuccessException { Session session = SessionFactory.createSession(); initializeFactory(); - return factory.doCreateNSEntry(session, name, Flags.NONE.getValue()); + return factory.doCreateNSEntry(session, name, Flags.READ.getValue()); } /** @@ -441,7 +441,7 @@ NoSuccessException { initializeFactory(); return factory - .doCreateNSDirectory(session, name, Flags.NONE.getValue()); + .doCreateNSDirectory(session, name, Flags.READ.getValue()); } /** @@ -552,7 +552,7 @@ Session session = SessionFactory.createSession(); initializeFactory(); return factory - .doCreateNSDirectory(session, name, Flags.NONE.getValue()); + .doCreateNSDirectory(session, name, Flags.READ.getValue()); } /** @@ -600,8 +600,8 @@ Session session, URL name) throws NotImplementedException, NoSuccessException { initializeFactory(); - return factory.doCreateNSEntry(mode, session, name, Flags.NONE - .getValue()); + return factory.doCreateNSEntry(mode, session, name, + Flags.READ.getValue()); } /** @@ -648,8 +648,8 @@ throws NotImplementedException, NoSuccessException { Session session = SessionFactory.createSession(); initializeFactory(); - return factory.doCreateNSEntry(mode, session, name, Flags.NONE - .getValue()); + return factory.doCreateNSEntry(mode, session, name, + Flags.READ.getValue()); } /** @@ -698,8 +698,8 @@ Session session, URL name) throws NotImplementedException, NoSuccessException { initializeFactory(); - return factory.doCreateNSDirectory(mode, session, name, Flags.NONE - .getValue()); + return factory.doCreateNSDirectory(mode, session, name, + Flags.READ.getValue()); } /** @@ -749,7 +749,7 @@ URL name) throws NotImplementedException, NoSuccessException { Session session = SessionFactory.createSession(); initializeFactory(); - return factory.doCreateNSDirectory(mode, session, name, Flags.NONE - .getValue()); + return factory.doCreateNSDirectory(mode, session, name, + Flags.READ.getValue()); } } Directory: /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/session/ ============================================================================================== File [modified]: Session.java Delta lines: +8 -1 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/session/Session.java 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/session/Session.java 2010-09-22 15:28:13 UTC (rev 1285) @@ -16,6 +16,12 @@ * * @param context * the context to be added. + * @exception NoSuccessException + * is thrown when the implementation is not able to initialize + * the context, and cannot use the context as-is. + * @exception TimeoutException + * is thrown if the context initialization implies a remote operation, + * and that operation times out. */ public void addContext(Context context) throws NoSuccessException, TimeoutException; @@ -32,7 +38,8 @@ /** * Retrieves all contexts attached to the session. An empty array is - * returned if no context is attached. + * returned if no context is attached. The contexts in the returned list + * are deep copies of the session's context. * * @return * a list of contexts. File [modified]: SessionFactory.java Delta lines: +3 -11 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/session/SessionFactory.java 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/session/SessionFactory.java 2010-09-22 15:28:13 UTC (rev 1285) @@ -2,7 +2,6 @@ import org.ogf.saga.bootstrap.ImplementationBootstrapLoader; import org.ogf.saga.error.NoSuccessException; -import org.ogf.saga.error.NotImplementedException; /** * Factory for creating sessions. @@ -27,7 +26,7 @@ * @return the session. */ protected abstract Session doCreateSession(boolean defaults) - throws NotImplementedException, NoSuccessException; + throws NoSuccessException; /** * Creates a session. @@ -38,15 +37,12 @@ * reflected in the default session. * @return * the session. - * @exception NotImplementedException - * is thrown if the implementation does not provide an - * implementation of this method. * @exception NoSuccessException * is thrown if the implementation cannot create valid * default values based on the available information. */ public static Session createSession(boolean defaults) - throws NotImplementedException, NoSuccessException { + throws NoSuccessException { initFactory(); return factory.doCreateSession(defaults); } @@ -57,15 +53,11 @@ * * @return * the session. - * @exception NotImplementedException - * is thrown if the implementation does not provide an - * implementation of this method. * @exception NoSuccessException * is thrown if the implementation cannot create valid * default values based on the available information. */ - public static Session createSession() throws NotImplementedException, - NoSuccessException { + public static Session createSession() throws NoSuccessException { return createSession(true); } } Directory: /trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/task/ =========================================================================================== File [modified]: TaskContainer.java Delta lines: +1 -3 =================================================================== --- trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/task/TaskContainer.java 2010-09-01 15:06:46 UTC (rev 1284) +++ trunk/documents/saga-core-binding-java/implementation/VU/src/org/ogf/saga/task/TaskContainer.java 2010-09-22 15:28:13 UTC (rev 1285) @@ -53,8 +53,6 @@ * * @param task * the task to be removed. - * @return - * the task. * @exception NotImplementedException * is thrown if the implementation does not provide an * implementation of this method. @@ -68,7 +66,7 @@ * is thrown when the operation was not successfully performed, * and none of the other exceptions apply. */ - public Task<?,?> remove(Task<?,?> task) throws NotImplementedException, + public void remove(Task<?,?> task) throws NotImplementedException, DoesNotExistException, TimeoutException, NoSuccessException; /**