类 RmiClientInterceptor

构造器详细资料

• RmiClientInterceptor

  public RmiClientInterceptor()

方法详细资料

• setLookupStubOnStartup

  public void setLookupStubOnStartup​(boolean lookupStubOnStartup)

  Set whether to look up the RMI stub on startup. Default is "true".

  Can be turned off to allow for late start of the RMI server. In this case, the RMI stub will be fetched on first access.

  另请参阅:

  setCacheStub(boolean)

• setCacheStub

  public void setCacheStub​(boolean cacheStub)

  Set whether to cache the RMI stub once it has been located. Default is "true".

  Can be turned off to allow for hot restart of the RMI server. In this case, the RMI stub will be fetched for each invocation.

  另请参阅:

  setLookupStubOnStartup(boolean)

• setRefreshStubOnConnectFailure

  public void setRefreshStubOnConnectFailure​(boolean refreshStubOnConnectFailure)

  Set whether to refresh the RMI stub on connect failure. Default is "false".

  Can be turned on to allow for hot restart of the RMI server. If a cached RMI stub throws an RMI exception that indicates a remote connect failure, a fresh proxy will be fetched and the invocation will be retried.

  另请参阅:

  ConnectException, ConnectIOException, NoSuchObjectException

• setRegistryClientSocketFactory

  public void setRegistryClientSocketFactory​(RMIClientSocketFactory registryClientSocketFactory)

  Set a custom RMI client socket factory to use for accessing the RMI registry.

  另请参阅:

  RMIClientSocketFactory, LocateRegistry.getRegistry(String, int, RMIClientSocketFactory)

• afterPropertiesSet

  public void afterPropertiesSet()

  从接口复制的说明: InitializingBean
  Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

  This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

  指定者:

  afterPropertiesSet 在接口中 InitializingBean

  覆盖:

  afterPropertiesSet 在类中 UrlBasedRemoteAccessor

• prepare

  public void prepare()
               throws RemoteLookupFailureException

  Fetches RMI stub on startup, if necessary.

  抛出:

  RemoteLookupFailureException - if RMI stub creation failed

  另请参阅:

  setLookupStubOnStartup(boolean), lookupStub()

• lookupStub

  protected Remote lookupStub()
                       throws RemoteLookupFailureException

  Create the RMI stub, typically by looking it up.

  Called on interceptor initialization if "cacheStub" is "true"; else called for each invocation by getStub().

  The default implementation looks up the service URL via java.rmi.Naming. This can be overridden in subclasses.

  返回:

  the RMI stub to store in this interceptor

  抛出:

  RemoteLookupFailureException - if RMI stub creation failed

  另请参阅:

  setCacheStub(boolean), Naming.lookup(java.lang.String)

• getStub

  protected Remote getStub()
                    throws RemoteLookupFailureException

  Return the RMI stub to use. Called for each invocation.

  The default implementation returns the stub created on initialization, if any. Else, it invokes lookupStub() to get a new stub for each invocation. This can be overridden in subclasses, for example in order to cache a stub for a given amount of time before recreating it, or to test the stub whether it is still alive.

  返回:

  the RMI stub to use for an invocation

  抛出:

  RemoteLookupFailureException - if RMI stub creation failed

  另请参阅:

  lookupStub()

• invoke

  public Object invoke​(MethodInvocation invocation)
                throws Throwable

  Fetches an RMI stub and delegates to doInvoke. If configured to refresh on connect failure, it will call refreshAndRetry(org.aopalliance.intercept.MethodInvocation) on corresponding RMI exceptions.

  指定者:

  invoke 在接口中 MethodInterceptor

  参数:

  invocation - the method invocation joinpoint

  返回:

  the result of the call to Joinpoint.proceed(); might be intercepted by the interceptor

  抛出:

  Throwable - if the interceptors or the target object throws an exception

  另请参阅:

  getStub(), doInvoke(MethodInvocation, Remote), refreshAndRetry(org.aopalliance.intercept.MethodInvocation), ConnectException, ConnectIOException, NoSuchObjectException

• isConnectFailure

  protected boolean isConnectFailure​(RemoteException ex)

  Determine whether the given RMI exception indicates a connect failure.

  The default implementation delegates to RmiClientInterceptorUtils.isConnectFailure(java.rmi.RemoteException).

  参数:

  ex - the RMI exception to check

  返回:

  whether the exception should be treated as connect failure

• refreshAndRetry

  protected Object refreshAndRetry​(MethodInvocation invocation)
                            throws Throwable

  Refresh the RMI stub and retry the given invocation. Called by invoke on connect failure.

  参数:

  invocation - the AOP method invocation

  返回:

  the invocation result, if any

  抛出:

  Throwable - in case of invocation failure

  另请参阅:

  invoke(org.aopalliance.intercept.MethodInvocation)

• doInvoke

  protected Object doInvoke​(MethodInvocation invocation,
                            Remote stub)
                     throws Throwable

  Perform the given invocation on the given RMI stub.

  参数:

  invocation - the AOP method invocation

  stub - the RMI stub to invoke

  返回:

  the invocation result, if any

  抛出:

  Throwable - in case of invocation failure

• doInvoke

  protected Object doInvoke​(MethodInvocation methodInvocation,
                            RmiInvocationHandler invocationHandler)
                     throws RemoteException,
                            NoSuchMethodException,
                            IllegalAccessException,
                            InvocationTargetException

  Apply the given AOP method invocation to the given RmiInvocationHandler.

  The default implementation delegates to RemoteInvocationBasedAccessor.createRemoteInvocation(org.aopalliance.intercept.MethodInvocation).

  参数:

  methodInvocation - the current AOP method invocation

  invocationHandler - the RmiInvocationHandler to apply the invocation to

  返回:

  the invocation result

  抛出:

  RemoteException - in case of communication errors

  NoSuchMethodException - if the method name could not be resolved

  IllegalAccessException - if the method could not be accessed

  InvocationTargetException - if the method invocation resulted in an exception

  另请参阅:

  RemoteInvocation