Module java.naming
Package javax.naming.spi

## Class ResolveResult

- java.lang.Object
- - javax.naming.spi.ResolveResult

- All Implemented Interfaces:
    `Serializable`

      public class ResolveResult
      extends Object
      implements Serializable

  This class represents the result of resolution of a name. It contains the object to which name was resolved, and the portion of the name that has not been resolved.

  A ResolveResult instance is not synchronized against concurrent multithreaded access. Multiple threads trying to access and modify a single ResolveResult instance should lock the object.

  Since:
    1.3
  See Also:
    Serialized Form

- - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `protected Name` | `remainingName` | Field containing the remaining name yet to be resolved.
    `protected Object` | `resolvedObj` | Field containing the Object that was resolved to successfully.

  - ### Constructor Summary

    Constructors
    Modifier | Constructor | Description
    --- | --- | ---
    `protected` | `ResolveResult()` | Constructs an instance of ResolveResult with the resolved object and remaining name both initialized to null.
    `` | `ResolveResult​(Object robj, String rcomp)` | Constructs a new instance of ResolveResult consisting of the resolved object and the remaining unresolved component.
    `` | `ResolveResult​(Object robj, Name rname)` | Constructs a new instance of ResolveResult consisting of the resolved Object and the remaining name.

  - ### Method Summary

    Modifier and Type | Method | Description
    --- | --- | ---
    `void` | `appendRemainingComponent​(String name)` | Adds a single component to the end of remaining name.
    `void` | `appendRemainingName​(Name name)` | Adds components to the end of remaining name.
    `Name` | `getRemainingName()` | Retrieves the remaining unresolved portion of the name.
    `Object` | `getResolvedObj()` | Retrieves the Object to which resolution was successful.
    `void` | `setRemainingName​(Name name)` | Sets the remaining name field of this result to name.
    `void` | `setResolvedObj​(Object obj)` | Sets the resolved Object field of this result to obj.

    - ### Methods declared in class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### resolvedObj

          protected Object resolvedObj

      Field containing the Object that was resolved to successfully. It can be null only when constructed using a subclass. Constructors should always initialize this.

    - #### remainingName

          protected Name remainingName

      Field containing the remaining name yet to be resolved. It can be null only when constructed using a subclass. Constructors should always initialize this.

  - ### Constructor Detail

    - #### ResolveResult

          protected ResolveResult()

      Constructs an instance of ResolveResult with the resolved object and remaining name both initialized to null.

    - #### ResolveResult

          public ResolveResult​(Object robj,
                               String rcomp)

      Constructs a new instance of ResolveResult consisting of the resolved object and the remaining unresolved component.
      Parameters:
        `robj` - The non-null object resolved to.
        `rcomp` - The single remaining name component that has yet to be resolved. Cannot be null (but can be empty).

    - #### ResolveResult

          public ResolveResult​(Object robj,
                               Name rname)

      Constructs a new instance of ResolveResult consisting of the resolved Object and the remaining name.
      Parameters:
        `robj` - The non-null Object resolved to.
        `rname` - The non-null remaining name that has yet to be resolved.

  - ### Method Detail

    - #### getRemainingName

          public Name getRemainingName()

      Retrieves the remaining unresolved portion of the name.
      Returns:
        The remaining unresolved portion of the name. Cannot be null but empty OK.
      See Also:
        `appendRemainingName(javax.naming.Name)`, `appendRemainingComponent(java.lang.String)`, `setRemainingName(javax.naming.Name)`

    - #### getResolvedObj

          public Object getResolvedObj()

      Retrieves the Object to which resolution was successful.
      Returns:
        The Object to which resolution was successful. Cannot be null.
      See Also:
        `setResolvedObj(java.lang.Object)`

    - #### setRemainingName

          public void setRemainingName​(Name name)

      Sets the remaining name field of this result to name. A copy of name is made so that modifying the copy within this ResolveResult does not affect `name` and vice versa.
      Parameters:
        `name` - The name to set remaining name to. Cannot be null.
      See Also:
        `getRemainingName()`, `appendRemainingName(javax.naming.Name)`, `appendRemainingComponent(java.lang.String)`

    - #### appendRemainingName

          public void appendRemainingName​(Name name)

      Adds components to the end of remaining name.
      Parameters:
        `name` - The components to add. Can be null.
      See Also:
        `getRemainingName()`, `setRemainingName(javax.naming.Name)`, `appendRemainingComponent(java.lang.String)`

    - #### appendRemainingComponent

          public void appendRemainingComponent​(String name)

      Adds a single component to the end of remaining name.
      Parameters:
        `name` - The component to add. Can be null.
      See Also:
        `getRemainingName()`, `appendRemainingName(javax.naming.Name)`

    - #### setResolvedObj

          public void setResolvedObj​(Object obj)

      Sets the resolved Object field of this result to obj.
      Parameters:
        `obj` - The object to use for setting the resolved obj field. Cannot be null.
      See Also:
        `getResolvedObj()`