Difference between revisions of "GeoFence library"
From Gcube Wiki
(→updateUserByUsername(String userName, String password, String email, boolean admin, boolean enabled)) |
(→updateUserByUsername(String userName, String password, String email, boolean admin, boolean enabled)) |
||
Line 94: | Line 94: | ||
*"password" : [String value] It's the password of user. | *"password" : [String value] It's the password of user. | ||
*"email" : [String value] It's the email of user. | *"email" : [String value] It's the email of user. | ||
− | *"admin" : [ | + | *"admin" : [boolean value] It's the boolean flag to define if user is administrator or not. |
− | *"enabled" : [ | + | *"enabled" : [boolean value] It's the boolean flag to define if user is enabled or not. |
'''Invocation example''' | '''Invocation example''' | ||
Line 101: | Line 101: | ||
String userName= ...; | String userName= ...; | ||
HttpStatus status = gf.updateUserByUsername(userName, "new_pass", "test@email.com", true, true); | HttpStatus status = gf.updateUserByUsername(userName, "new_pass", "test@email.com", true, true); | ||
+ | </source> | ||
+ | |||
+ | |||
+ | ===deleteUserById(String id, boolean removeAllRules)=== | ||
+ | |||
+ | Parameters List : | ||
+ | *"id" : [String value] It's the userId of user you are looking for; | ||
+ | *"removeAllRules" : [boolean value] It's a flag to remove all rules together to the user; | ||
+ | |||
+ | '''Invocation example''' | ||
+ | <source lang="java5"> | ||
+ | String id = ...; | ||
+ | HttpStatus status = gf.deleteUserById(id, true); | ||
</source> | </source> | ||
==Group section== | ==Group section== |
Revision as of 16:20, 21 November 2017
This section aims to describe the Geofence library in order to help developers to manage users, groups, rules and instances in Geofence server. After configuring between Geofence server with GeoServer, for instance, it's possible create an user in Geofence and automatically it's possible to login (with this user) in GeoServer. Following is a list of methods, with all details to uderstand how invoke them.
Contents
- 1 Constructor
- 2 User section
- 2.1 getUserById(String id)
- 2.2 getUserByUsername(String userName)
- 2.3 createUser(User user)
- 2.4 updateUser(User user)
- 2.5 updateUserById(String id, String password, String email, boolean admin, boolean enabled)
- 2.6 updateUserByUsername(String userName, String password, String email, boolean admin, boolean enabled)
- 2.7 deleteUserById(String id, boolean removeAllRules)
- 3 Group section
Constructor
Parameters List :
- "geofenceRestUrl" : [String value] The URL of Geofence instance;
Invocation example
GeoFence gf = new GeoFence("http://geofenceRestUrl/");
User section
getUserById(String id)
Parameters List :
- "id" : [String value] It's the userId of user you are looking for;
Invocation example
String id = ...; GSUser user = gf.getUserById(id); String userName = user.getName();
getUserByUsername(String userName)
Parameters List :
- "userName" : [String value] It's the name of user you are looking for;
Invocation example
String userName = ...; GSUser user = gf.getUserByUsername(userName); String id = user.getId();
createUser(User user)
Parameters List :
- "user" : [User value] It's the org.gcube.data.access.bean.User object you are creating;
Invocation example
User user = new User(); user.setExtId("id_1"); user.setName("test_1"); user.setPassword("test"); ... HttpStatus status = gf.createUser(user);
updateUser(User user)
Parameters List :
- "user" : [User value] It's the org.gcube.data.access.bean.User object you are updating;
Invocation example
User user = new User(); user.setExtId("id_1"); user.setName("test_1"); user.setPassword("test_1"); user.setEmailAddress("test@email.com"); ... HttpStatus status = gf.updateUser(user);
updateUserById(String id, String password, String email, boolean admin, boolean enabled)
Parameters List :
- "id" : [String value] It's the id of user;
- "password" : [String value] It's the password of user.
- "email" : [String value] It's the email of user.
- "admin" : [String value] It's the boolean flag to define if user is administrator or not.
- "enabled" : [String value] It's the boolean flag to define if user is enabled or not.
Invocation example
String id = ...; HttpStatus status = gf.updateUserById(id, "new_pass", "test@email.com", false, false);
updateUserByUsername(String userName, String password, String email, boolean admin, boolean enabled)
Parameters List :
- "userName" : [String value] It's the userName of user;
- "password" : [String value] It's the password of user.
- "email" : [String value] It's the email of user.
- "admin" : [boolean value] It's the boolean flag to define if user is administrator or not.
- "enabled" : [boolean value] It's the boolean flag to define if user is enabled or not.
Invocation example
String userName= ...; HttpStatus status = gf.updateUserByUsername(userName, "new_pass", "test@email.com", true, true);
deleteUserById(String id, boolean removeAllRules)
Parameters List :
- "id" : [String value] It's the userId of user you are looking for;
- "removeAllRules" : [boolean value] It's a flag to remove all rules together to the user;
Invocation example
String id = ...; HttpStatus status = gf.deleteUserById(id, true);