Flags (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.mail Class Flags

java.lang.Object
  extended by javax.mail.Flags
所有已实现的接口:
Serializable, Cloneable

public class Flags
extends Object
implements Cloneable, Serializable

The Flags class represents the set of flags on a Message. Flags are composed of predefined system flags, and user defined flags.

A System flag is represented by the Flags.Flag inner class. A User defined flag is represented as a String. User flags are case-independent.

A set of standard system flags are predefined. Most folder implementations are expected to support these flags. Some implementations may also support arbitrary user-defined flags. The getPermanentFlags method on a Folder returns a Flags object that holds all the flags that are supported by that folder implementation.

A Flags object is serializable so that (for example) the use of Flags objects in search terms can be serialized along with the search terms.

Warning: Serialized objects of this class may not be compatible with future JavaMail API releases. The current serialization support is appropriate for short term storage.

The below code sample illustrates how to set, examine and get the flags for a message.

 Message m = folder.getMessage(1);
 m.setFlag(Flags.Flag.DELETED, true); // set the DELETED flag

 // Check if DELETED flag is set of this message
 if (m.isSet(Flags.Flag.DELETED))
        System.out.println("DELETED message");

 // Examine ALL system flags for this message
 Flags flags = m.getFlags();
 Flags.Flag[] sf = flags.getSystemFlags();
 for (int i = 0; i < sf.length; i++) {
        if (sf[i] == Flags.Flag.DELETED)
            System.out.println("DELETED message");
        else if (sf[i] == Flags.Flag.SEEN)
            System.out.println("SEEN message");
      ......
      ......
 }
 

作者:
John Mani, Bill Shannon
另请参见:
Folder.getPermanentFlags(), Serialized Form

嵌套类摘要
static class Flags.Flag
          This inner class represents an individual system flag.
 
构造器摘要
Flags()
          Construct an empty Flags object.
Flags(Flags.Flag flag)
          Construct a Flags object initialized with the given system flag.
Flags(Flags flags)
          Construct a Flags object initialized with the given flags.
Flags(String flag)
          Construct a Flags object initialized with the given user flag.
 
方法摘要
 void add(Flags.Flag flag)
          Add the specified system flag to this Flags object.
 void add(Flags f)
          Add all the flags in the given Flags object to this Flags object.
 void add(String flag)
          Add the specified user flag to this Flags object.
 Object clone()
          Returns a clone of this Flags object.
 boolean contains(Flags.Flag flag)
          Check whether the specified system flag is present in this Flags object.
 boolean contains(Flags f)
          Check whether all the flags in the specified Flags object are present in this Flags object.
 boolean contains(String flag)
          Check whether the specified user flag is present in this Flags object.
 boolean equals(Object obj)
          Check whether the two Flags objects are equal.
 Flags.Flag[] getSystemFlags()
          Return all the system flags in this Flags object.
 String[] getUserFlags()
          Return all the user flags in this Flags object.
 int hashCode()
          Compute a hash code for this Flags object.
 void remove(Flags.Flag flag)
          Remove the specified system flag from this Flags object.
 void remove(Flags f)
          Remove all flags in the given Flags object from this Flags object.
 void remove(String flag)
          Remove the specified user flag from this Flags object.
 
类方法继承 java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

构造器详细信息

Flags

public Flags()
Construct an empty Flags object.


Flags

public Flags(Flags flags)
Construct a Flags object initialized with the given flags.

参数:
flags - the flags for initialization


Flags

public Flags(Flags.Flag flag)
Construct a Flags object initialized with the given system flag.

参数:
flag - the flag for initialization


Flags

public Flags(String flag)
Construct a Flags object initialized with the given user flag.

参数:
flag - the flag for initialization

方法详细信息

add

public void add(Flags.Flag flag)
Add the specified system flag to this Flags object.

参数:
flag - the flag to add

add

public void add(String flag)
Add the specified user flag to this Flags object.

参数:
flag - the flag to add

add

public void add(Flags f)
Add all the flags in the given Flags object to this Flags object.

参数:
f - Flags object

remove

public void remove(Flags.Flag flag)
Remove the specified system flag from this Flags object.

参数:
flag - the flag to be removed

remove

public void remove(String flag)
Remove the specified user flag from this Flags object.

参数:
flag - the flag to be removed

remove

public void remove(Flags f)
Remove all flags in the given Flags object from this Flags object.

参数:
f - the flag to be removed

contains

public boolean contains(Flags.Flag flag)
Check whether the specified system flag is present in this Flags object.

返回:
true of the given flag is present, otherwise false.

contains

public boolean contains(String flag)
Check whether the specified user flag is present in this Flags object.

返回:
true of the given flag is present, otherwise false.

contains

public boolean contains(Flags f)
Check whether all the flags in the specified Flags object are present in this Flags object.

返回:
true if all flags in the given Flags object are present, otherwise false.

equals

public boolean equals(Object obj)
Check whether the two Flags objects are equal.

重写:
equals in class Object
返回:
true if they're equal

hashCode

public int hashCode()
Compute a hash code for this Flags object.

重写:
hashCode in class Object
返回:
the hash code

getSystemFlags

public Flags.Flag[] getSystemFlags()
Return all the system flags in this Flags object. Returns an array of size zero if no flags are set.

返回:
array of Flags.Flag objects representing system flags

getUserFlags

public String[] getUserFlags()
Return all the user flags in this Flags object. Returns an array of size zero if no flags are set.

返回:
array of Strings, each String represents a flag.

clone

public Object clone()
Returns a clone of this Flags object.

重写:
clone in class Object

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.