{"__v":2,"_id":"55a938ba4c661b3700cf4e1f","category":{"__v":11,"_id":"55a93098cf45e1390093f351","pages":["55a930bdcf45e1390093f353","55a932afc8bd450d000dd1d6","55a938ba4c661b3700cf4e1f","55a939b502becf2d007aac34","55a93a015d3abb0d0012f184","55a93b225d3abb0d0012f191","55a93c4002becf2d007aac43","55a93d4c02becf2d007aac4c","55a940485d3abb0d0012f1af","55a9409802becf2d007aac64","55a9410c5d3abb0d0012f1b4"],"project":"559a61d2dbcfd20d00710b39","version":"559a61d2dbcfd20d00710b3c","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-17T16:43:04.054Z","from_sync":false,"order":4,"slug":"android-sdk-reference","title":"Android SDK Reference"},"parentDoc":null,"project":"559a61d2dbcfd20d00710b39","user":"559a618bdbcfd20d00710b38","version":{"__v":23,"_id":"559a61d2dbcfd20d00710b3c","project":"559a61d2dbcfd20d00710b39","createdAt":"2015-07-06T11:09:06.510Z","releaseDate":"2015-07-06T11:09:06.510Z","categories":["559a61d3dbcfd20d00710b3d","55a589ddaaf9cf1900114dd0","55a589e30f354f0d00fd0312","55a589ea80c8a30d00b323cc","55a589f6aaf9cf1900114dd1","55a58d4e80c8a30d00b323e6","55a8e7a227a17d21005251a2","55a93098cf45e1390093f351","55afb085f202b12100cd9e83","55afb22e902fd51700f5f8bf","55afb260902fd51700f5f8c2","55afb28ec8a85321007a5462","55afb294f202b12100cd9e95","55afb29b902fd51700f5f8c5","55afb2a1c8a85321007a5463","55afb2a7902fd51700f5f8c7","55afb2ad902fd51700f5f8c8","55afb2b5902fd51700f5f8ca","55b74b2131bccb190081bedc","55bb441b54f9640d006e6cf2","565711085cb2420d00d70071","5681681330018c0d006bf7ff","588f38b5923d610f00c72dad"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"Version 1.0","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-17T17:17:46.264Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"- The app User object manages information about current application user.\n- This object is optional, and it is used when the app needs to authenticate the user. \n- The authentication provides data about user’s identity a *unique user* ID or similar. \n- The user login and logout calls are managed by the app.\n\n\nTo access existing *User object*, use currentUser property: \u000b\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"// Access authenticated user object\\nMOCAUser theUser = MOCA.getInstance().getUser();\\nif (theUser != null) {\\n    // ...\\n}\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]\nTo *authenticate* a new user, use *login(id)* call:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"// Authenticate a user by e-mail address    \\nMOCAUser theUser = MOCA.getInstance().login(”UNIQUE_USER_ID”);\\n// ...\\n\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]\nTo **logout** a user, call:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"theUser.logout();\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]\n- The user object holds a **collection of properties**. Property-value pairs can be set and retrieved.\n- Each user object is **persisted both locally and in the cloud**. \n- It is recommended to perform as many sets as desired and then \njust invoke a single save operation to persist them to the MOCA cloud.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"MOCAUser theUser = MOCA.getInstance().login(\\\"some_unique_id\\\");\\nif (theUser != null) {\\n    theUser.save(new MOCACallback<MOCAUser>() {\\n        :::at:::Override\\n        public void success(MOCAUser user) {\\n            Log.i(TAG, \\\"Login successful\\\");\\n        }\\n\\n        @Override\\n        public void failure(MOCAException e) {\\n            Log.e(TAG, \\\"Login failed\\\", e);\\n        }\\n    });\\n}\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"user-api-1","type":"basic","title":"User API"}
- The app User object manages information about current application user. - This object is optional, and it is used when the app needs to authenticate the user. - The authentication provides data about user’s identity a *unique user* ID or similar. - The user login and logout calls are managed by the app. To access existing *User object*, use currentUser property: [block:code] { "codes": [ { "code": "// Access authenticated user object\nMOCAUser theUser = MOCA.getInstance().getUser();\nif (theUser != null) {\n // ...\n}", "language": "java" } ] } [/block] To *authenticate* a new user, use *login(id)* call: [block:code] { "codes": [ { "code": "// Authenticate a user by e-mail address \nMOCAUser theUser = MOCA.getInstance().login(”UNIQUE_USER_ID”);\n// ...\n", "language": "java" } ] } [/block] To **logout** a user, call: [block:code] { "codes": [ { "code": "theUser.logout();", "language": "java" } ] } [/block] - The user object holds a **collection of properties**. Property-value pairs can be set and retrieved. - Each user object is **persisted both locally and in the cloud**. - It is recommended to perform as many sets as desired and then just invoke a single save operation to persist them to the MOCA cloud. [block:code] { "codes": [ { "code": "MOCAUser theUser = MOCA.getInstance().login(\"some_unique_id\");\nif (theUser != null) {\n theUser.save(new MOCACallback<MOCAUser>() {\n @Override\n public void success(MOCAUser user) {\n Log.i(TAG, \"Login successful\");\n }\n\n @Override\n public void failure(MOCAException e) {\n Log.e(TAG, \"Login failed\", e);\n }\n });\n}", "language": "java" } ] } [/block]