/**
* Refreshes the properties of this Partition object instance with values from the AFS partition
* it represents. All properties that have been initialized and/or accessed will be renewed
* according to the values of the AFS partition this Partition object instance represents.
*
* <p>Since in most environments administrative changes can be administered from an AFS
* command-line program or an alternate GUI application, this method provides a means to refresh
* the Java object representation and thereby ascertain any possible modifications that may have
* been made from such alternate administrative programs. Using this method before an associated
* instance accessor will ensure the highest level of representative accuracy, accommodating
* changes made external to the Java application space. If administrative changes to the
* underlying AFS system are only allowed via this API, then the use of this method is
* unnecessary.
*
* @exception AFSException If an error occurs in the native code
*/
public void refresh() throws AFSException {
refresh(false);
}
/**
* Constructs a new <CODE>Partition</CODE> object instance given the name of the AFS partition and
* the AFS server, represented by <CODE>server</CODE>, to which it belongs. This does not actually
* create a new AFS partition, it just represents an existing one. If <code>name</code> is not an
* actual AFS partition, exceptions will be thrown during subsequent method invocations on this
* object.
*
* <p>This constructor is ideal for point-in-time representation and transient applications. It
* ensures all data member values are set and available without calling back to the filesystem at
* the first request for them. Use the {@link #refresh()} method to address any coherency
* concerns.
*
* @param name the name of the partition to represent
* @param server the server to which the partition belongs.
* @param preloadAllMembers true will ensure all object members are set upon construction;
* otherwise members will be set upon access, which is the default behavior.
* @exception AFSException If an error occurs in the native code
* @see #refresh
*/
public Partition(String name, Server server, boolean preloadAllMembers) throws AFSException {
this(name, server);
if (preloadAllMembers) refresh(true);
}