NAME

       UR::Context::AutoUnloadPool - Automatically unload objects when scope ends

SYNOPSIS

         my $not_unloaded = Some::Class->get(...);
         do {
           my $guard = UR::Context::AutoUnloadPool->create();
           my $object = Some::Class->get(...);  # load an object from the database
           ...                                  # load more things
         };  # $guard goes out of scope - unloads objects

DESCRIPTION

       UR Objects retrieved from the database normally live in the object cache for the life of
       the program.  When a UR::Context::AutoUnloadPool is instantiated, it tracks every object
       loaded during its life.  The Pool's destructor calls unload() on those objects.

       Changed objects and objects loaded before before the Pool is created will not get
       unloaded.

METHODS

       create
             my $guard = UR::Context::AutoUnloadPool->create();

           Creates a Pool object.  All UR Objects loaded from the database during this object's
           lifetime will get unloaded when the Pool goes out of scope.

       delete
             $guard->delete();

           Invalidates the Pool object.  No objects are unloaded.  When the Pool later goes out
           of scope, no objects will be unloaded.

SEE ALSO

       UR::Object, UR::Context