| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (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.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package org.apache.yoko.orb.OB; |
| |
| // |
| // IDL:orb.yoko.apache.org/OB/RetryPolicy:1.0 |
| // |
| /** |
| * |
| * The retry policy. This policy is used to specify retry behavior after |
| * communication failures (i.e., <code>CORBA::TRANSIENT</code> and |
| * <code>CORBA::COMM_FAILURE</code> exceptions). |
| * |
| **/ |
| |
| public interface RetryPolicyOperations extends org.omg.CORBA.PolicyOperations |
| { |
| // |
| // IDL:orb.yoko.apache.org/OB/RetryPolicy/retry_mode:1.0 |
| // |
| /** |
| * |
| * For retry_mode <code>RETRY_NEVER</code> indicates that requests |
| * should never be retried, and the exception is re-thrown to the |
| * application. <code>RETRY_STRICT</code> will retry once if the |
| * exception completion status is <code>COMPLETED_NO</code>, in |
| * order to guarantee at-most-once semantics. <code>RETRY_ALWAYS</code> |
| * will retry once, regardless of the exception completion |
| * status. The default value is <code>RETRY_STRICT</code>. |
| * |
| * retry_interval is the time in milliseconds between reties. The |
| * default is 0. |
| * |
| * retry_max is the maximum number of retries. The default is 1. |
| * |
| * retry_remote determines whether or not to retry on exceptions |
| * received over-the-wire. The default is false: only retry on |
| * locally generated exceptions. |
| * |
| * <B>Note:</B> Many TCP/IP stacks do not provide a reliable |
| * indication of communication failure when sending smaller |
| * requests, therefore the failure may not be detected until the |
| * ORB attempts to read the reply. In this case, the ORB must |
| * assume that the remote end has received the request, in order |
| * to guarantee at-most-once semantics for the request. The |
| * implication is that when using the default setting of |
| * <code>RETRY_STRICT</code>, most communication failures will not |
| * cause a retry. This behavior can be relaxed using |
| * <code>RETRY_ALWAYS</code>. |
| * |
| **/ |
| |
| short |
| retry_mode(); |
| |
| // |
| // IDL:orb.yoko.apache.org/OB/RetryPolicy/retry_interval:1.0 |
| // |
| /***/ |
| |
| int |
| retry_interval(); |
| |
| // |
| // IDL:orb.yoko.apache.org/OB/RetryPolicy/retry_max:1.0 |
| // |
| /***/ |
| |
| int |
| retry_max(); |
| |
| // |
| // IDL:orb.yoko.apache.org/OB/RetryPolicy/retry_remote:1.0 |
| // |
| /***/ |
| |
| boolean |
| retry_remote(); |
| } |