Interface AutoBean<T>

Type Parameters:
T - the type of interface that will be wrapped.

public interface AutoBean<T>
A controller for an implementation of a bean interface. Instances of AutoBeans are obtained from an AutoBeanFactory.
  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static @interface 
    An annotation that allows inferred property names to be overridden.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Accept an AutoBeanVisitor.
    as()
    Returns a proxy implementation of the T interface which will delegate to the underlying wrapped object, if any.
    clone(boolean deep)
    Deprecated.
    with no replacement
    Returns the AutoBeanFactory that created the AutoBean.
    <Q> Q
    getTag(String tagName)
    Retrieve a tag value that was previously provided to setTag(String, Object).
    Returns the wrapped interface type.
    boolean
    Returns the value most recently passed to setFrozen(boolean), or false if it has never been called.
    boolean
    Returns true if the AutoBean was provided with an external object.
    void
    setFrozen(boolean frozen)
    Disallows any method calls other than getters.
    void
    setTag(String tagName, Object value)
    A tag is an arbitrary piece of external metadata to be associated with the wrapped value.
    If the AutoBean wraps an object, return the underlying object.
  • Method Details

    • accept

      void accept(AutoBeanVisitor visitor)
      Accept an AutoBeanVisitor.
      Parameters:
      visitor - an AutoBeanVisitor
    • as

      T as()
      Returns a proxy implementation of the T interface which will delegate to the underlying wrapped object, if any.
      Returns:
      a proxy that delegates to the wrapped object
    • clone

      @Deprecated AutoBean<T> clone(boolean deep)
      Deprecated.
      with no replacement
      This method always throws an UnsupportedOperationException. The implementation of this method in previous releases was not sufficiently robust and there are no further uses of this method within the GWT code base. Furthermore, there are many different semantics that can be applied to a cloning process that cannot be adequately addressed with a single implementation.

      A simple clone of an acyclic datastructure can be created by using AutoBeanCodex to encode and decode the root object. Other cloning algorithms are best implemented by using an AutoBeanVisitor.

      Throws:
      UnsupportedOperationException
    • getFactory

      AutoBeanFactory getFactory()
      Returns the AutoBeanFactory that created the AutoBean.
      Returns:
      an AutoBeanFactory
    • getTag

      <Q> Q getTag(String tagName)
      Retrieve a tag value that was previously provided to setTag(String, Object).
      Parameters:
      tagName - the tag name
      Returns:
      the tag value
      See Also:
    • getType

      Class<T> getType()
      Returns the wrapped interface type.
    • isFrozen

      boolean isFrozen()
      Returns the value most recently passed to setFrozen(boolean), or false if it has never been called.
      Returns:
      true if this instance is frozen
    • isWrapper

      boolean isWrapper()
      Returns true if the AutoBean was provided with an external object.
      Returns:
      true if this instance is a wrapper
    • setFrozen

      void setFrozen(boolean frozen)
      Disallows any method calls other than getters. All setter and call operations will throw an IllegalStateException.
      Parameters:
      frozen - if true, freeze this instance
    • setTag

      void setTag(String tagName, Object value)
      A tag is an arbitrary piece of external metadata to be associated with the wrapped value.
      Parameters:
      tagName - the tag name
      value - the wrapped value
      See Also:
    • unwrap

      T unwrap()
      If the AutoBean wraps an object, return the underlying object. The AutoBean will no longer function once unwrapped.
      Returns:
      the previously-wrapped object
      Throws:
      IllegalStateException - if the AutoBean is not a wrapper