com.perforce.p4java.server
Class AuthTicketsHelper

java.lang.Object
  com.perforce.p4java.server.AbstractAuthHelper
      com.perforce.p4java.server.AuthTicketsHelper

public class AuthTicketsHelper
extends AbstractAuthHelper

This class is designed to lookup authentication tickets from a tickets file or the in-memory tickets map. If a null tickets file parameter is passed to the methods, the in-memory tickets map will be used instead.

AuthTicketsHelper

public AuthTicketsHelper()

getTicketValue

public static String getTicketValue(String userName,
                                    String serverAddress,
                                    String ticketsFilePath)
                             throws IOException

Get the first found ticket value that matches the specified user name and server address. The user name be non-null and the server address must be non-null and be of the form server:port.

Parameters:

userName -

serverAddress -

ticketsFilePath -

Returns:

- ticket value or null if not found

Throws:

IOException - - io exception from reading tickets file

getTickets

public static AuthTicket[] getTickets(String ticketsFilePath)
                               throws IOException

Get all the tickets found in the file at the specified file path.

Parameters:

ticketsFilePath -

Returns:

- array of tickets found in the specified tickets file at the specified path

Throws:

IOException - - io exception from reading tickets file

getTickets

public static AuthTicket[] getTickets(File ticketsFile)
                               throws IOException

Get all the tickets found in the specified file.

Parameters:

ticketsFile -

Returns:

- array of tickets found in the specified tickets file

Throws:

IOException - - io exception from reading tickets file

getTicket

public static AuthTicket getTicket(String userName,
                                   String serverAddress,
                                   String ticketsFilePath)
                            throws IOException

Get the first found ticket in the specified ticket file that matches the specified user name and server address. The server address must be non-null and be of the form server:port. The user name may be null and if that is the case the found first ticket for the specified server address will be returned.

Parameters:

userName - - possibly null user name to match against the found tickets

serverAddress - - non-null server address

ticketsFilePath - - path to tickets file to search

Returns:

- found ticket or null if not found

Throws:

IOException - - io exception from reading tickets file

getTicket

public static AuthTicket getTicket(String serverAddress,
                                   String ticketsFilePath)
                            throws IOException

Get the first found ticket in the specified ticket file that matches the specified server address. The server address must be non-null and be of the form server:port.

Parameters:

serverAddress - - non-null server address

ticketsFilePath - - path to tickets file to search

Returns:

- found ticket or null if not found

Throws:

IOException - - io exception from reading tickets file

saveTicket

public static void saveTicket(AuthTicket ticket,
                              String ticketsFilePath)
                       throws IOException

Save the specified ticket as an entry into the specified tickets file. This method will replace the current entry for the user name and server address in the tickets file. If a current entry is not found then the specified entry will be appended to the file.

Parameters:

ticket - - non-null ticket

ticketsFilePath - - non-null path

Throws:

IOException

saveTicket

public static void saveTicket(AuthTicket ticket,
                              File ticketsFile)
                       throws IOException

Save the specified ticket as an entry into the specified tickets file. This method will replace the current entry for the user name and server address in the tickets file. If a current entry is not found then the specified entry will be appended to the file.

Parameters:

ticket - - non-null ticket

ticketsFile - - non-null file

Throws:

IOException

saveTicket

public static void saveTicket(String userName,
                              String serverAddress,
                              String ticketValue,
                              String ticketsFilePath)
                       throws IOException

Save the specified parameters as an entry into the specified tickets file. This method will replace the current entry for the user name and server address in the tickets file. If a current entry is not found then the specified entry will be appended to the file.

Parameters:

userName - - non-null user name

serverAddress - - non-null server address

ticketValue - - non-null ticket value

ticketsFilePath - - non-null file path

Throws:

IOException

saveTicket

public static void saveTicket(String userName,
                              String serverAddress,
                              String ticketValue,
                              File ticketsFile)
                       throws IOException

Save the specified parameters as an entry into the specified tickets file. This method will replace the current entry for the user name and server address in the tickets file. If a current entry is not found then the specified entry will be appended to the file. If the specified ticket value is null then the current entry in the specified file will be removed if found.

Parameters:

userName - - non-null user name

serverAddress - - non-null server address

ticketValue - - possibly null ticket value

ticketsFile - - non-null file

Throws:

IOException