Java Tutorial TaskManager

In this tutorial you will learn to:

set up a backend with a custom class “Task”.
deploy the backend
create a simple Java-Project with the generated sdk
set up the connection to the backend and create a User
have a look at the data in your backend
create Task-Objects in Java and store it in the backend
query data from the backend

1. Sign Up or login with your existing account here to start using backend as a service.
images/download/attachments/12649133/LogIn.png

2. Now enter a unique name for your application e.g. “YourNameTaskManager”.

Since we plan to give developers the opportunity to share projects application names must be unique in the system. You do not need any of the predefined modules in this tutorial.

images/download/attachments/12649133/task_newBackend.png

3. Create a new module by going to the Module Market and clicking on "New Module" in the submenu. Choose a name and description and click "CREATE".

images/download/attachments/12649133/newNmModule.png

4. Go to the "Class Editor"- Tab to create a class in our backend. You will be asked for a class name after entering the tab. Just call the first class „Task“. Scroll down to the attributes and add a String “description”, a Number “done” and a Date “untilDate”.

images/download/attachments/12649133/task_addClassAttributes.png

5. Deploy your Backend by pressing the “Deploy”-Button.

6. Go to SDK-tab. Scroll down to Java. Press the Button "Download SDK". You will get a zip file with your generated classes and all necessary libs.

images/download/attachments/12649133/task_downloadJavaSDK.png
7. Now set up a java project in Eclipse. Add the lib-folder to your project and add all included .jars to your projects build path. Add the folders "com" and "rpc" in your projects src-Folder.

images/download/attachments/12649133/Eclipse.png

8. Now you are ready to go. Create a class "ClientExample" with the following code:

import java.util.List;
import com.apiomat.frontend.Datastore;
import com.apiomat.frontend.yournametaskmanagermain.Task;
import com.apiomat.frontend.basics.User;
 
public class ClientExample
{
 public static void main(String[] args) throws Exception {
  User user = new User();
  user.setUserName("tester");
  user.setPassword("mySecretPassword");
  Datastore.configureWithCredentials(User.baseURL,
    User.apiKey,
    user.getUserName(),user.getPassword(),
    User.sdkVersion,
    User.system);
  try {
    user.loadMe();
  } catch (Exception e) {
    // if loadMe fails create the user
    user.save();
  }
 }
}

Note that the import

import com.apiomat.frontend.yournametaskmanagermain.Task;

depends on the name of your Backend App. So in general:

import com.apiomat.frontend.NAMEOFYOURAPP.Task;

9. Your Backend and your connection are working now. Run your client once and have a look in the Data-Tab of your Dashboard to see the so created user in your Backend.

images/download/attachments/12649133/task_newUserCreated.png

10. Now let’s play around with the Task-Class. Add the following code at the end of your main-method to create two tasks, one that is done and another one that isn’t.

Task myTask = new Task();
myTask.setDescription("make Java Tutorials");
myTask.setDone(1L);
myTask.save();
Task myTask2 = new Task();
myTask2.setDescription("buy Ice Cream");
myTask2.setDone(0L);
myTask2.save();

11. Now you can get all Tasks that are not done with a query from the server and iterate over it. Just add the code again at the end of your main method.

List<task> results_done = Task.getTasks( "done==0");
for (Task task : results_done) {
System.out.println(task.getDescription());
}