com.dropbox.core.v2.sharing

Class MemberSelector

java.lang.Object

com.dropbox.core.v2.sharing.MemberSelector

public final class MemberSelector
extends Object

Includes different ways to identify a member of a shared folder.

This class is an open tagged union. Tagged unions instances are always associated to a specific tag. This means only one of the isAbc() methods will return true. You can use tag() to determine the tag associated with this instance.

Open unions may be extended in the future with additional tags. If a new tag is introduced that this SDK does not recognized, the OTHER value will be used.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MemberSelector.Tag Discriminating tag type for MemberSelector.

Field Summary

Fields

Modifier and Type	Field and Description
static MemberSelector	OTHER Catch-all used for unknown tag values returned by the Dropbox servers.

Method Summary

Modifier and Type	Method and Description
static MemberSelector	dropboxId(String value) Returns an instance of MemberSelector that has its tag set to MemberSelector.Tag.DROPBOX_ID.
static MemberSelector	email(String value) Returns an instance of MemberSelector that has its tag set to MemberSelector.Tag.EMAIL.
boolean	equals(Object obj)
String	getDropboxIdValue() Dropbox account, team member, or group ID of member.
String	getEmailValue() E-mail address of member.
int	hashCode()
boolean	isDropboxId() Returns true if this instance has the tag MemberSelector.Tag.DROPBOX_ID, false otherwise.
boolean	isEmail() Returns true if this instance has the tag MemberSelector.Tag.EMAIL, false otherwise.
boolean	isOther() Returns true if this instance has the tag MemberSelector.Tag.OTHER, false otherwise.
MemberSelector.Tag	tag() Returns the tag for this instance.
String	toString()
String	toStringMultiline() Returns a String representation of this object formatted for easier readability.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

OTHER

public static final MemberSelector OTHER

Catch-all used for unknown tag values returned by the Dropbox servers.

Receiving a catch-all value typically indicates this SDK version is not up to date. Consider updating your SDK version to handle the new tags.

Method Detail

tag

public MemberSelector.Tag tag()

Returns the tag for this instance.

This class is a tagged union. Tagged unions instances are always associated to a specific tag. This means only one of the isXyz() methods will return true. Callers are recommended to use the tag value in a switch statement to properly handle the different values for this MemberSelector.

If a tag returned by the server is unrecognized by this SDK, the MemberSelector.Tag.OTHER value will be used.

Returns:

the tag for this instance.

isDropboxId

public boolean isDropboxId()

Returns true if this instance has the tag MemberSelector.Tag.DROPBOX_ID, false otherwise.

Returns:

true if this instance is tagged as MemberSelector.Tag.DROPBOX_ID, false otherwise.

dropboxId

public static MemberSelector dropboxId(String value)

Returns an instance of MemberSelector that has its tag set to MemberSelector.Tag.DROPBOX_ID.

Dropbox account, team member, or group ID of member.

Parameters:

value - value to assign to this instance.

Returns:

Instance of MemberSelector with its tag set to MemberSelector.Tag.DROPBOX_ID.

Throws:

IllegalArgumentException - if value is shorter than 1 or is null.

getDropboxIdValue

public String getDropboxIdValue()

Dropbox account, team member, or group ID of member.

This instance must be tagged as MemberSelector.Tag.DROPBOX_ID.

Returns:

The dropboxId(java.lang.String) value associated with this instance if isDropboxId() is true.

Throws:

IllegalStateException - If isDropboxId() is false.

isEmail

public boolean isEmail()

Returns true if this instance has the tag MemberSelector.Tag.EMAIL, false otherwise.

Returns:

true if this instance is tagged as MemberSelector.Tag.EMAIL, false otherwise.

email

public static MemberSelector email(String value)

Returns an instance of MemberSelector that has its tag set to MemberSelector.Tag.EMAIL.

E-mail address of member.

Parameters:

value - value to assign to this instance.

Returns:

Instance of MemberSelector with its tag set to MemberSelector.Tag.EMAIL.

Throws:

IllegalArgumentException - if value is longer than 255, does not match pattern "^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$", or is null.

getEmailValue

public String getEmailValue()

E-mail address of member.

This instance must be tagged as MemberSelector.Tag.EMAIL.

Returns:

The email(java.lang.String) value associated with this instance if isEmail() is true.

Throws:

IllegalStateException - If isEmail() is false.

isOther

public boolean isOther()

Returns true if this instance has the tag MemberSelector.Tag.OTHER, false otherwise.

Returns:

true if this instance is tagged as MemberSelector.Tag.OTHER, false otherwise.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

toStringMultiline

public String toStringMultiline()

Returns a String representation of this object formatted for easier readability.

The returned String may contain newlines.

Returns:

Formatted, multiline String representation of this object