View Javadoc

1   /* (c) Copyright 2003 Caleigo AB, All rights reserved. 
2    * 
3    * This library is free software; you can redistribute it and/or
4    * modify it under the terms of the GNU Lesser General Public
5    * License as published by the Free Software Foundation; either
6    * version 2.1 of the License, or (at your option) any later version.
7    * 
8    * This library is distributed in the hope that it will be useful,
9    * but WITHOUT ANY WARRANTY; without even the implied warranty of
10   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11   * Lesser General Public License for more details.
12   * 
13   * You should have received a copy of the GNU Lesser General Public
14   * License along with this library; if not, write to the Free Software
15   * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16   *  
17   */
18  
19  package org.caleigo.service;
20  
21  /*** An IProxyService is a proxy for a remote IService. It handles invokations
22   * on a service interface by communicating with a remote IService with the help
23   * of an ITunnel.
24   *
25   * @author  Mattias Hagstrand
26   * @version 1.00
27   * 
28   *//* 
29   *
30   * WHEN        WHO               WHY & WHAT
31   * ------------------------------------------------------------------------------
32   * 2002-07-29  Mattias Hagstrand    Creation
33   */
34  public interface IProxyService extends IService
35  {
36      /*** Returns <code>true</code> if this IProxyService can be reconnected to
37       * an IService.
38       */
39      public boolean isReconnectable();
40      
41      /*** Tries to reconnect to the provided service. If the reconnection fails
42       * or if this IProxyService doesn't support reconnection an exception is
43       * thrown.
44       */
45      public void reconnect(org.caleigo.toolkit.tunnel.ITunnel tunnel) throws ServiceException;
46      
47      /*** Sets the ITunnel that should be used by this IProxyService.
48       */
49      public void setServiceTunnel(org.caleigo.toolkit.tunnel.ITunnel tunnel);
50  }