Package io.microsphere.lang

Interface Wrapper

    • Method Summary

      All Methods Static Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      boolean isWrapperFor​(java.lang.Class<?> type)
      Returns true if this either extends or implements the type argument or is directly or indirectly a wrapper for an object that does.
      static <T> T tryUnwrap​(java.lang.Object object, java.lang.Class<T> type)
      Try to unwrap the specified object and target type
      <T> T unwrap​(java.lang.Class<T> type)
      Returns an object of the given class to allow access to non-standard methods, or standard methods not exposed by the proxy.

    • Method Detail

      • unwrap

        <T> T unwrap​(java.lang.Class<T> type)
      throws java.lang.IllegalArgumentException
        Returns an object of the given class to allow access to non-standard methods, or standard methods not exposed by the proxy.

        If the receiver extends or implements the type then the result is the receiver or a proxy for the receiver. If the receiver is a wrapper and the wrapped object extends or implements the type then the result is the wrapped object or a proxy for the wrapped object. Otherwise return the result of calling unwrap recursively on the wrapped object or a proxy for that result. If the receiver is not a wrapper and does not implement the type, then an IllegalArgumentException is thrown.

        Type Parameters:
        T - the wrapped type
        Parameters:
        type - the wrapped type
        Returns:
        an object of the given class. Maybe a proxy for the actual implementing object.
        Throws:
        java.lang.IllegalArgumentException

      • isWrapperFor

        boolean isWrapperFor​(java.lang.Class<?> type)
        Returns true if this either extends or implements the type argument or is directly or indirectly a wrapper for an object that does. Returns false otherwise. If this extends or implements the type then return true, else if this is a wrapper then return the result of recursively calling isWrapperFor on the wrapped object. If this does not implement the type and is not a wrapper, return false. This method should be implemented as a low-cost operation compared to unwrap so that callers can use this method to avoid expensive unwrap calls that may fail. If this method returns true then calling unwrap with the same argument should succeed.
        Parameters:
        type - the wrapped type
        Returns:
        true if this extends or implements the type or directly or indirectly wraps an object that does

      • tryUnwrap

        static <T> T tryUnwrap​(java.lang.Object object,
                       java.lang.Class<T> type)
        Try to unwrap the specified object and target type
        Type Parameters:
        T - target type
        Parameters:
        object - maybe Wrapper
        type - target type
        Returns:
        unwrapped instance if possible, or the original object