Set Up SAP Business Application Studio for CAP Java

Before you can start using SAP Business Application Studio, you need to create your developer space, where your project will run. Depending on the application you want to develop, you can create different types of dev spaces.

For this tutorial, you will create a dev space personalized for building services and applications with CAP.

Before you begin, check the settings of your browser. You need to add domains ondemand.com and cloud.sap.com to the list of the exceptions to enable pop-ups and new tabs and disable the ad blocker extension if you use one.

1. Go to the SAP BTP Cockpit on Trial.

2. Choose SAP Business Application Studio under Quick Tool Access.

   

3. On the welcome page choose Create Dev Space.

4. Type CAPTutorial as the name for your dev space and select Full Stack Cloud Application as the application type. Continue with Create Dev Space.

   

   By selecting Full Stack Cloud Application, your space comes with several extensions out of the box that you will need to develop CAP applications. For example, CDS tools are built in. This saves unnecessary setup time. The creation of the dev space takes a few seconds.

5. When it’s ready, open your dev space by clicking on the name.

   

   Please note that you’re using the trial version of SAP Business Application Studio. See section Restrictions in the SAP Business Application Studio documentation for more details on how your development environment can be affected.

1. Change the color theme to your preferences.

   Go to File → Preferences → Color Theme and choose an item from the list. We used Dark (Visual Studio).

2. From the main menu, choose Terminal → New Terminal.

   

3. A terminal window should now have been opened on the bottom of the window. From the terminal, run cd projects to go to the projects directory.

   

4. Now, run:

   Shell/Bash Copy

   cds init products-service --add java

   This will initialize the application using the maven archetype cds-services-archetype and create your project as follows:

   • The project is named products-service.

   • The db folder stores database-related artifacts.

   • The srv folder stores your Java application.

     

5. From the main menu, choose File → Open Folder.

6. Choose projects → products-service and then OK.

   

   If you see a notification asking if you want to synchronize the Java classpath/configuration, choose Always.

   If you have any problem indication for any of the pom.xml files yet, don’t worry; ignore them for now.

CAP applications use Core Data Services (CDS) to describe:

• Data structures by using entity definitions
• How data structures are consumed by using service definitions

In this step, you will define a simple service, which also defines its own entity. In more complex applications, services usually expose projections on entities defined in the data model.

1. Right-click on the srv folder and choose New File.

   

2. Call it admin-service.cds and choose OK to create the file.

3. Add the following service definition to the file and make sure you Save the file (keyboard shortcut CTRL+S):

   CDS Copy

   service AdminService {
       entity Products {
           key ID : Integer;
           title  : String(111);
           descr  : String(1111);
       }
   }