com.nsqre.insquare.Utilities.REST

Class VolleyManager

java.lang.Object

com.nsqre.insquare.Utilities.REST.VolleyManager

public class VolleyManager
extends java.lang.Object

This class manages the HTTP requests made with Volley from all the Activities and Fragments of the application

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	VolleyManager.VolleyResponseListener<E> An interface to manage responses from the server

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	baseURL
(package private) boolean	connection
private Context	context
private static VolleyManager	instance
private static java.util.Locale	locale
static java.lang.String	OK_RESPONSE
com.android.volley.RequestQueue	requestQueue
private static java.lang.String	TAG
private java.lang.String[]	URL_Array

Constructor Summary

Constructors

Modifier	Constructor and Description
private	VolleyManager(Context c)

Method Summary

Modifier and Type	Method and Description
void	deleteSquare(java.lang.String squareId, java.lang.String ownerId, VolleyManager.VolleyResponseListener listener) Deletes a square and all the messages contained in it from the database
java.util.List<Message>	deserializeMessages(java.lang.String jsonResponse) Deserializes a list of messages received from the server
java.util.List<Square>	deserializeSquares(java.lang.String jsonResponse) Deserializes a list of squares received from the server
private java.lang.String	emptySpacesForParams(java.lang.String urlParameter) Removes empty spaces from strings
void	getClosestSquares(java.lang.String distance, double lat, double lon, VolleyManager.VolleyResponseListener listener) Searchs on the server's database for squares around a certain position and a certain distance
void	getFavoriteSquares(java.lang.String userId, VolleyManager.VolleyResponseListener listener) Downloads user's favourite squares
static VolleyManager	getInstance()
static VolleyManager	getInstance(Context c)
void	getOwnedSquares(java.lang.String byOwner, java.lang.String ownerId, VolleyManager.VolleyResponseListener listener) Downloads user's owned squares
void	getRecentMessages(java.lang.String isRecentRequest, java.lang.String howMany, java.lang.String squareId, VolleyManager.VolleyResponseListener listener) Gets the most recent messages from a square
void	getRecentSquares(java.lang.String userId, VolleyManager.VolleyResponseListener listener) Downloads user's recent squares
void	handleFavoriteSquare(int requestType, java.lang.String squareId, java.lang.String userId, VolleyManager.VolleyResponseListener listener) Adds or removes a square from the user's favourite
void	patchDescription(java.lang.String name, java.lang.String description, java.lang.String squareId, java.lang.String ownerId, VolleyManager.VolleyResponseListener listener) Updates name and description of the square
void	patchGCMToken(java.lang.String token, VolleyManager.VolleyResponseListener listener) Updates the GCM Token, if expired
void	patchLocation(java.lang.String latitude, java.lang.String longitude, java.lang.String userId, java.lang.String isUpdateLocation, VolleyManager.VolleyResponseListener listener) Updates the location of a square
void	patchLoginToken(java.lang.String service, java.lang.String accessToken, VolleyManager.VolleyResponseListener listener) Updates the access token for the login
void	postFacebookSquare(java.lang.String squareName, java.lang.String squareDescr, java.lang.String latitude, java.lang.String longitude, java.lang.String ownerId, java.lang.String squareType, java.lang.String facebookId, java.lang.String expireTime, VolleyManager.VolleyResponseListener listener) POST request to create a Facebook square (Page or Event)
void	postFeedback(java.lang.String feedback, java.lang.String userId, java.lang.String fromActivity, VolleyManager.VolleyResponseListener listener) Sends a feedback that will be stored on the backend database
void	postLoginToken(java.lang.String service, java.lang.String accessToken, VolleyManager.VolleyResponseListener listener) Manages the POST request to login via Google/Facebook
void	postSquare(java.lang.String squareName, java.lang.String squareDescr, java.lang.String latitude, java.lang.String longitude, java.lang.String ownerId, VolleyManager.VolleyResponseListener listener) POST request to create a new square
void	searchSquares(java.lang.String query, java.lang.String userId, double lat, double lon, VolleyManager.VolleyResponseListener listener) Searches for squares in the server's database

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OK_RESPONSE

public static final java.lang.String OK_RESPONSE

See Also:

Constant Field Values

TAG

private static final java.lang.String TAG

See Also:

Constant Field Values

instance

private static VolleyManager instance

locale

private static java.util.Locale locale

context

private Context context

URL_Array

private java.lang.String[] URL_Array

baseURL

private static java.lang.String baseURL

connection

boolean connection

requestQueue

public com.android.volley.RequestQueue requestQueue

Constructor Detail

VolleyManager

private VolleyManager(Context c)

Method Detail

getInstance

public static VolleyManager getInstance(Context c)

getInstance

public static VolleyManager getInstance()

searchSquares

public void searchSquares(java.lang.String query,
                          java.lang.String userId,
                          double lat,
                          double lon,
                          VolleyManager.VolleyResponseListener listener)

Searches for squares in the server's database

Parameters:

query - the query of the user

userId - the id of the user

lat - the latitude of the position of the user

lon - the longitude of the position of the user

listener - the listener to handle the results

getClosestSquares

public void getClosestSquares(java.lang.String distance,
                              double lat,
                              double lon,
                              VolleyManager.VolleyResponseListener listener)

Searchs on the server's database for squares around a certain position and a certain distance

Parameters:

distance - the radius of research

lat - the latitude of the position of the user

lon - the longitude of the position of the user

listener - the listener to handle the results

getRecentMessages

public void getRecentMessages(java.lang.String isRecentRequest,
                              java.lang.String howMany,
                              java.lang.String squareId,
                              VolleyManager.VolleyResponseListener listener)

Gets the most recent messages from a square

Parameters:

isRecentRequest - if true gets the user the most recent messages

howMany - the number of messages to download

squareId - the square id from which to download

listener - the listener to handle the results

handleFavoriteSquare

public void handleFavoriteSquare(int requestType,
                                 java.lang.String squareId,
                                 java.lang.String userId,
                                 VolleyManager.VolleyResponseListener listener)

Adds or removes a square from the user's favourite

Parameters:

requestType - POST for adding, DELETE for removing

squareId - the square to add/remove

userId - the user's id

listener - the listener to handle the results

postLoginToken

public void postLoginToken(java.lang.String service,
                           java.lang.String accessToken,
                           VolleyManager.VolleyResponseListener listener)

Manages the POST request to login via Google/Facebook

Parameters:

service - the service you want to use

accessToken - the access token

listener - the listener to handle the results

patchLoginToken

public void patchLoginToken(java.lang.String service,
                            java.lang.String accessToken,
                            VolleyManager.VolleyResponseListener listener)

Updates the access token for the login

Parameters:

service - the service you want to use

accessToken - the access token

listener - the listener to handle the results

patchGCMToken

public void patchGCMToken(java.lang.String token,
                          VolleyManager.VolleyResponseListener listener)

Updates the GCM Token, if expired

Parameters:

token - the new token

listener - the listener to handle the results

postFeedback

public void postFeedback(java.lang.String feedback,
                         java.lang.String userId,
                         java.lang.String fromActivity,
                         VolleyManager.VolleyResponseListener listener)

Sends a feedback that will be stored on the backend database

Parameters:

feedback - the feedback

userId - the user that submitted it

fromActivity - from which activity it was submitted

listener - the listener to handle the results

postSquare

public void postSquare(java.lang.String squareName,
                       java.lang.String squareDescr,
                       java.lang.String latitude,
                       java.lang.String longitude,
                       java.lang.String ownerId,
                       VolleyManager.VolleyResponseListener listener)

POST request to create a new square

Parameters:

squareName - name of the square

squareDescr - description of the square

latitude - latitude of the position of the square

longitude - longitude of the position of the square

ownerId - the id of the owner

listener - the listener to handle the results

postFacebookSquare

public void postFacebookSquare(java.lang.String squareName,
                               java.lang.String squareDescr,
                               java.lang.String latitude,
                               java.lang.String longitude,
                               java.lang.String ownerId,
                               java.lang.String squareType,
                               java.lang.String facebookId,
                               java.lang.String expireTime,
                               VolleyManager.VolleyResponseListener listener)

POST request to create a Facebook square (Page or Event)

Parameters:

squareName - name of the square

squareDescr - description of the square

latitude - latitude of the position of the square

longitude - longitude of the position of the square

ownerId - the id of the owner

squareType - type of the square

facebookId - Facebook's id of the page/event

expireTime - expiration time of the square

listener - the listener to handle the results

getOwnedSquares

public void getOwnedSquares(java.lang.String byOwner,
                            java.lang.String ownerId,
                            VolleyManager.VolleyResponseListener listener)

Downloads user's owned squares

Parameters:

byOwner - true if the research is for the owner

ownerId - the id of the owner

listener - the listener to handle the results

getFavoriteSquares

public void getFavoriteSquares(java.lang.String userId,
                               VolleyManager.VolleyResponseListener listener)

Downloads user's favourite squares

Parameters:

userId - the id of the user

listener - the listener to handle the results

getRecentSquares

public void getRecentSquares(java.lang.String userId,
                             VolleyManager.VolleyResponseListener listener)

Downloads user's recent squares

Parameters:

userId - the id of the user

listener - the listener to handle the results

deserializeSquares

public java.util.List<Square> deserializeSquares(java.lang.String jsonResponse)

Deserializes a list of squares received from the server

Parameters:

jsonResponse - the data received from the server

Returns:

a list of Square objects

deserializeMessages

public java.util.List<Message> deserializeMessages(java.lang.String jsonResponse)

Deserializes a list of messages received from the server

Parameters:

jsonResponse - the data received from the server

Returns:

a list of Message objects

patchDescription

public void patchDescription(java.lang.String name,
                             java.lang.String description,
                             java.lang.String squareId,
                             java.lang.String ownerId,
                             VolleyManager.VolleyResponseListener listener)

Updates name and description of the square

Parameters:

name - the new name

description - the new description

squareId - the id of the square to update

ownerId - the id of the owner of the square

listener - the listener to handle the results

patchLocation

public void patchLocation(java.lang.String latitude,
                          java.lang.String longitude,
                          java.lang.String userId,
                          java.lang.String isUpdateLocation,
                          VolleyManager.VolleyResponseListener listener)

Updates the location of a square

Parameters:

latitude - the new latitude of the square

longitude - the new longitude of the square

userId - the id of the user

isUpdateLocation - true if the location has to be updated

listener - the listener to handle the results

deleteSquare

public void deleteSquare(java.lang.String squareId,
                         java.lang.String ownerId,
                         VolleyManager.VolleyResponseListener listener)

Deletes a square and all the messages contained in it from the database

Parameters:

squareId - the id of the square

ownerId - the id of the owner

listener - the listener to handle the results

emptySpacesForParams

private java.lang.String emptySpacesForParams(java.lang.String urlParameter)

Removes empty spaces from strings

Parameters:

urlParameter - the url

Returns:

the initial string with spaces replaced by '%20'