INTEGRATION: CWS sb23 (1.1.2); FILE ADDED

2005/03/15 10:29:35 sb 1.1.2.3: #88601# Support for current context in Java URP.
2005/03/14 15:00:49 sb 1.1.2.2: #i35277# Further cleanup.
2005/03/14 10:56:26 sb 1.1.2.1: #i35277# Further cleanup.

1 files changed, 229 insertions, 0 deletions

diff --git a/jurt/com/sun/star/lib/uno/environments/remote/Message.java b/jurt/com/sun/star/lib/uno/environments/remote/Message.java
new file mode 100644
index 000000000000..672a1f0a35bb
--- /dev/null
+++ b/jurt/com/sun/star/lib/uno/environments/remote/Message.java
@@ -0,0 +1,229 @@
+/*************************************************************************
+ *
+ *  $RCSfile: Message.java,v $
+ *
+ *  $Revision: 1.2 $
+ *
+ *  last change: $Author: rt $ $Date: 2006-12-01 14:51:47 $
+ *
+ *  The Contents of this file are made available subject to the terms of
+ *  either of the following licenses
+ *
+ *         - GNU Lesser General Public License Version 2.1
+ *         - Sun Industry Standards Source License Version 1.1
+ *
+ *  Sun Microsystems Inc., October, 2000
+ *
+ *  GNU Lesser General Public License Version 2.1
+ *  =============================================
+ *  Copyright 2000 by Sun Microsystems, Inc.
+ *  901 San Antonio Road, Palo Alto, CA 94303, USA
+ *
+ *  This library is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU Lesser General Public
+ *  License version 2.1, as published by the Free Software Foundation.
+ *
+ *  This library is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ *  Lesser General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Lesser General Public
+ *  License along with this library; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ *  MA  02111-1307  USA
+ *
+ *
+ *  Sun Industry Standards Source License Version 1.1
+ *  =================================================
+ *  The contents of this file are subject to the Sun Industry Standards
+ *  Source License Version 1.1 (the "License"); You may not use this file
+ *  except in compliance with the License. You may obtain a copy of the
+ *  License at http://www.openoffice.org/license.html.
+ *
+ *  Software provided under this License is provided on an "AS IS" basis,
+ *  WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+ *  WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
+ *  MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
+ *  See the License for the specific provisions governing your rights and
+ *  obligations concerning the Software.
+ *
+ *  The Initial Developer of the Original Code is: Sun Microsystems, Inc.
+ *
+ *  Copyright: 2000 by Sun Microsystems, Inc.
+ *
+ *  All Rights Reserved.
+ *
+ *  Contributor(s): _______________________________________
+ *
+ *
+ ************************************************************************/
+
+package com.sun.star.lib.uno.environments.remote;
+
+import com.sun.star.uno.IMethodDescription;
+import com.sun.star.uno.ITypeDescription;
+import com.sun.star.uno.XCurrentContext;
+
+/**
+   A remote request or reply message.
+*/
+public class Message {
+    public Message(
+        ThreadId threadId, boolean request, String objectId,
+        ITypeDescription type, IMethodDescription method, boolean synchronous,
+        XCurrentContext currentContext, boolean abnormalTermination,
+        Object result, Object[] arguments)
+    {
+        this.threadId = threadId;
+        this.request = request;
+        this.objectId = objectId;
+        this.type = type;
+        this.method = method;
+        this.synchronous = synchronous;
+        this.currentContext = currentContext;
+        this.abnormalTermination = abnormalTermination;
+        this.result = result;
+        this.arguments = arguments;
+    }
+
+    /**
+       Returns the thread ID of the message.
+
+       <p>Valid for all kinds of messages.</p>
+
+       @return the (non-<code>null</code>) thread ID
+    */
+    public final ThreadId getThreadId() {
+        return threadId;
+    }
+
+    /**
+       Returns whether the message is a request or a reply.
+
+       <p>Valid for all kinds of messages.</p>
+
+       @return <code>true</code> for a request, <code>false</code> for a reply
+    */
+    public final boolean isRequest() {
+        return request;
+    }
+
+    /**
+       Returns the object ID of a request message.
+
+       <p>Valid only for request messages.</p>
+
+       @return the (non-<code>null</code>) object ID for a request,
+       <code>null</code> for a reply
+    */
+    public final String getObjectId() {
+        return objectId;
+    }
+
+    /**
+       Returns the type of a request message.
+
+       <p>Valid only for request messages.</p>
+
+       @return the (non-<code>null</code>) type for a request, <code>null</code>
+       for a reply
+    */
+    public final ITypeDescription getType() {
+        return type;
+    }
+
+    /**
+       Returns the method description of a request message.
+
+       <p>Valid only for request messages.  The returned
+       <code>IMethodDescription</code> is consistent with the type of the
+       message.</p>
+
+       @return the (non-<code>null</code>) method description for a request,
+       <code>null</code> for a reply
+    */
+    public final IMethodDescription getMethod() {
+        return method;
+    }
+
+    /**
+       Returns whether the request message is synchronous.
+
+       <p>Valid only for request messages.</p>
+
+       @return <code>true</code> for a synchronous request, <code>false</code>
+       for an asynchronous request or a reply
+    */
+    public final boolean isSynchronous() {
+        return synchronous;
+    }
+
+    /**
+       Returns the current context of a request message.
+
+       <p>Valid only for request messages.</p>
+
+       @return the current context (which may be <code>null</code>) for a
+       request, <code>null</code> for a reply
+    */
+    public XCurrentContext getCurrentContext() {
+        return currentContext;
+    }
+
+    /**
+       Returns whether the reply message represents abnormal termination.
+
+       <p>Valid only for reply messages.</p>
+
+       @return <code>true</code> for a reply that represents abnormal
+       termination, <code>false</code> for a reply that represents normal
+       termination or a request
+    */
+    public final boolean isAbnormalTermination() {
+        return abnormalTermination;
+    }
+
+    /**
+       Returns the result of a reply message.
+
+       <p>Valid only for reply messages.</p>
+
+       @return any (possibly <code>null</code>) return value for a reply that
+       represents normal termination, the (non-<code>null</code>) exception for
+       a reply that represents abnormal termination, <code>null</code> for a
+       request
+    */
+    public final Object getResult() {
+        return result;
+    }
+
+    /**
+       Returns the arguments of a message.
+
+       <p>Valid only for request messages and reply messages that represent
+       normal termination.  Any returned array must not be modified.</p>
+
+       @return the in and in&ndash {
+    }out arguments for a request (possibly
+       <code>null</code> for a paramterless function), the out and in&dash {
+    }out
+       arguments for a reply that represents normal termination (possibly
+       <code>null</code> for a parameterless function), <code>null</code> for a
+       reply that represents abnormal termination
+    */
+    public final Object[] getArguments() {
+        return arguments;
+    }
+
+    private final ThreadId threadId;
+    private final boolean request;
+    private final String objectId;
+    private final ITypeDescription type;
+    private final IMethodDescription method;
+    private final boolean synchronous;
+    private final XCurrentContext currentContext;
+    private final boolean abnormalTermination;
+    private final Object result;
+    private final Object[] arguments;
+}