com.perforce.p4java.core
Interface IUserSummary

All Superinterfaces:
IServerResource
All Known Subinterfaces:
IUser
All Known Implementing Classes:
User, UserSummary

public interface IUserSummary
extends IServerResource

Defines a Perforce user summary as returned from an IServer getUsers method and similar. IUserSummary objects contain only the summary information returned by the p4 users command; to get the full user information from the server, use the IUser interface returned from getUser, etc. Fields and methods below are basically self-explanatory and more detailed documentation can be found in the main p4 documentation. Note that any or all of these methods are allowed to return null.

IUserSummary objects are complete and neither refreshable nor updateable.


Nested Class Summary
static class IUserSummary.UserType
          Describes the type (service or standard) of this user.
 
Method Summary
 Date getAccess()
           
 String getEmail()
           
 String getFullName()
           
 String getLoginName()
           
 Date getPasswordChange()
          Get the date the password associated with this summary user expires.
 Date getTicketExpiration()
          Get the date the ticket associated with this summary user expires.
 IUserSummary.UserType getType()
          Get the UserType associated with this user.
 Date getUpdate()
           
 void setAccess(Date access)
           
 void setEmail(String email)
           
 void setFullName(String fullName)
           
 void setLoginName(String loginName)
           
 void setType(IUserSummary.UserType type)
          Set the UserType associated with this user.
 void setUpdate(Date update)
           
 
Methods inherited from interface com.perforce.p4java.core.IServerResource
canRefresh, canUpdate, refresh, setServer, update, update, update
 

Method Detail

getLoginName

String getLoginName()

setLoginName

void setLoginName(String loginName)

getUpdate

Date getUpdate()

setUpdate

void setUpdate(Date update)

getAccess

Date getAccess()

setAccess

void setAccess(Date access)

getFullName

String getFullName()

setFullName

void setFullName(String fullName)

getEmail

String getEmail()

setEmail

void setEmail(String email)

getType

IUserSummary.UserType getType()
Get the UserType associated with this user. May return null if no type was set.

Since:
2011.1

setType

void setType(IUserSummary.UserType type)
Set the UserType associated with this user.

Since:
2011.1

getTicketExpiration

Date getTicketExpiration()
Get the date the ticket associated with this summary user expires.

This field will only be non-null if a) the user summary object it's a part of was retrieved using the IOptionsServer.getUsers method with the GetUsersOptions().setExtendedOutput option set to true; b) the caller was a super-user or admin; and, c) the Perforce server was 2011.1 or above. In all other cases the value of this field is either null or not reliable. This is a read-only field synthesized by the Perforce server, and can not be meaningfully set in the client.

Returns:
possibly-null Date object.
Since:
2011.1

getPasswordChange

Date getPasswordChange()
Get the date the password associated with this summary user expires.

This field will only be non-null if a) the user summary object it's a part of was retrieved using the IOptionsServer.getUsers method with the GetUsersOptions().setExtendedOutput option set to true; b) the caller was a super-user or admin; and, c) the Perforce server was 2011.1 or above. In all other cases the value of this field is either null or not reliable. This is a read-only field synthesized by the Perforce server, and can not be meaningfully set in the client.

Returns:
possibly-null Date object.
Since:
2011.1


Copyright © 2015 Perforce Software. All Rights Reserved.