Class Overview
An object reference that may be updated atomically. See the java.util.concurrent.atomic package specification for description
 of the properties of atomic variables.
 
Summary
| Public Constructors | 
	 
    
        | 
            
            
            
            
            
            
         | 
        
        AtomicReference(V initialValue)
        
         Creates a new AtomicReference with the given initial value. 
  
   | 
	 
    
        | 
            
            
            
            
            
            
         | 
        
        AtomicReference()
        
         Creates a new AtomicReference with null initial value. 
  
   | 
| Public Methods | 
	 
    
        | 
            
            
            final
            
            
            boolean
         | 
        
        compareAndSet(V expect, V update)
        
         Atomically sets the value to the given updated value
 if the current value == the expected value. 
  
   | 
	 
    
        | 
            
            
            final
            
            
            V
         | 
        
        get()
        
         Gets the current value. 
  
   | 
	 
    
        | 
            
            
            final
            
            
            V
         | 
        
        getAndSet(V newValue)
        
         Atomically sets to the given value and returns the old value. 
  
   | 
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        lazySet(V newValue)
        
         Eventually sets to the given value. 
  
   | 
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        set(V newValue)
        
         Sets to the given value. 
  
   | 
	 
    
        | 
            
            
            
            
            
            String
         | 
        
        toString()
        
         Returns the String representation of the current value. 
  
   | 
	 
    
        | 
            
            
            final
            
            
            boolean
         | 
        
        weakCompareAndSet(V expect, V update)
        
         Atomically sets the value to the given updated value
 if the current value == the expected value. 
  
   | 
| 
  [Expand]
   Inherited Methods  | 
   
From class
  java.lang.Object
  
   
  
    
    
	 
    
        | 
            
            
            
            
            
            Object
         | 
        
        clone()
        
         Creates and returns a copy of this Object. 
  
   |  
	 
    
        | 
            
            
            
            
            
            boolean
         | 
        
        equals(Object o)
        
         Compares this instance with the specified object and indicates if they
 are equal. 
  
   |  
	 
    
        | 
            
            
            
            
            
            void
         | 
        
        finalize()
        
         Invoked when the garbage collector has detected that this instance is no longer reachable. 
  
   |  
	 
    
        | 
            
            
            final
            
            
            Class<?>
         | 
        
        getClass()
        
        Returns the unique instance of  Class that represents this
 object's class.  
  
   |  
	 
    
        | 
            
            
            
            
            
            int
         | 
        
        hashCode()
        
         Returns an integer hash code for this object. 
  
   |  
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        notify()
        
         Causes a thread which is waiting on this object's monitor (by means of
 calling one of the wait() methods) to be woken up. 
  
   |  
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        notifyAll()
        
         Causes all threads which are waiting on this object's monitor (by means
 of calling one of the wait() methods) to be woken up. 
  
   |  
	 
    
        | 
            
            
            
            
            
            String
         | 
        
        toString()
        
         Returns a string containing a concise, human-readable description of this
 object. 
  
   |  
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        wait()
        
         Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object. 
  
   |  
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        wait(long millis, int nanos)
        
         Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
 specified timeout expires. 
  
   |  
	 
    
        | 
            
            
            final
            
            
            void
         | 
        
        wait(long millis)
        
         Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
 specified timeout expires. 
  
   |  
 
   
 
 | 
 
Public Constructors
 
    
      
        public 
         
         
         
         
        
      
      AtomicReference
      (V initialValue)
    
      
    
      
  Creates a new AtomicReference with the given initial value.
 
  
      Parameters
      
        
          | initialValue
           | the initial value
 | 
        
      
   
     
 
 
    
      
        public 
         
         
         
         
        
      
      AtomicReference
      ()
    
      
    
      
  Creates a new AtomicReference with null initial value.
 
     
 
Public Methods
 
    
      
        public 
         
        final 
         
         
        boolean
      
      compareAndSet
      (V expect, V update)
    
      
    
      
  Atomically sets the value to the given updated value
 if the current value == the expected value.
 
  
      Parameters
      
        
          | expect
           | the expected value | 
        
        
          | update
           | the new value | 
        
      
   
  
      Returns
      - true if successful. False return indicates that
 the actual value was not equal to the expected value.
 
   
     
 
 
    
      
        public 
         
        final 
         
         
        V
      
      getAndSet
      (V newValue)
    
      
    
      
  Atomically sets to the given value and returns the old value.
 
  
  
     
 
 
    
      
        public 
         
        final 
         
         
        void
      
      lazySet
      (V newValue)
    
      
    
      
  Eventually sets to the given value.
 
  
     
 
 
    
      
        public 
         
        final 
         
         
        void
      
      set
      (V newValue)
    
      
    
 
 
    
      
        public 
         
         
         
         
        String
      
      toString
      ()
    
      
    
      
  Returns the String representation of the current value.
 
  
      Returns
      - the String representation of the current value.
 
   
     
 
 
    
      
        public 
         
        final 
         
         
        boolean
      
      weakCompareAndSet
      (V expect, V update)
    
      
    
      
  Atomically sets the value to the given updated value
 if the current value == the expected value.
 
May fail spuriously
 and does not provide ordering guarantees, so is only rarely an
 appropriate alternative to compareAndSet.
 
  
      Parameters
      
        
          | expect
           | the expected value | 
        
        
          | update
           | the new value |