REST - es gibt eine REST API, wie mache ich nun in JAVA weiter?

[beta20]

Hallo zusammen,

ich habe von einer Software eine REST API.

Beispiel:
http://othercompany.com/api/v1/Customers/{id}
-> Liefert mir Informationen zu einem einzelnen Kunden aus
application/json

Das ganze sieht dann so aus:

{
  "Id": "5996a94681b200088ca84f1a",
  "CreatedAt": "2018-10-18T15:38:21.9832827+02:00",
  "IsDeletable": false,
  "DeletedAt": "0001-01-01T00:00:00",
  "IsLocked": false,
  "CustomerName": "Wallace, Marcellus",
  "CustomerSubName": "",
  "FirstName": "Marcellus",
  "LastName": "Wallace",
  "Language": "en-US",
  "EmailAddress": "marcellus@example.org",
  "Address": {
    "Street": "Raymond Ave (Holly)",
    "HouseNumber": "145",
    "PostalCode": "91001",
    "City": "Pasadena",
    "Country": "CA"
  },
  "Locale": "en-US",
  "CustomFields": {
    "CustomFieldName": "CustomFieldValue",
    "Name": "Value"
  },
  "DefaultBearerMedium": "Email",
  "CustomerType": "Consumer",
  "Hidden": false
}

Was ich nun machen möchte:
- Eine Entity "Customer" erstellen, sodass Objekte gespeichert / weiterverarbeitet werden können.

public class Customer....
private boolean locked
private String firstName
....

Die Frage ist nun aber, wie erstelle ich das Objekt?
Also wie sieht die Methode aus, um das Objekt "Customer" mit der REST API zu bekommen?
-> Hier als Beispiel möchte ich den Kunden mit der ID2 bekommen.
http://othercompany.com/api/v1/Customers/2
-> Wie erstelle ich nun das Objekt Customer?

Danke & Gruß

 

[Robat]

Die Requests kannst du bspw über
HttpURLConnection absetzen. Beispiele dazu gibt es im Netz wie Sand am Meer

 

[mrBrown]

Am einfachsten z.B mit jax-rs (https://www.baeldung.com/jersey-jax-rs-client) oder Spring Resttemplate (https://www.baeldung.com/rest-template)

 

[dzim]

Oder mit Retrofit (https://square.github.io/retrofit/). Mag ich persönlich recht gern und verwende es auch in Spring Applikationen, die Daten anderer Services konsumieren müssen.

 

[beta20]

Vielen Dank.

Noch konkret eine Frage:
Ich möchte diese REST API anbinden.
https://developer.billwerk.io/Docs/ApiReference

Ich habe nun jeweils Klassen erstellt, wie:

public class ContractPhaseDTO {
       
       private String type;
        private String startDate;
        private String planVariantId;
        private String planId;
    private String externalBillingReceiptId;
    private String externalBillingType;
    private integer quantity;
    private boolean inheritStartDate;
    
+ Getter & Setter
}

Reicht dies schon aus, oder benötige ich etwas wie dieses zur "Übersetzung".

private ContractPhaseDTO(@JsonProperty("Id") String id,
                          @JsonProperty("Type") String type,
                          @JsonProperty("StartDate") String startDate,
                          @JsonProperty("PlanVariantId") String planVariantId,
                          @JsonProperty("PlanId") String planId) {
        this.id = id;
        this.type= type;
        this.startDate= startDate;
        ....
}

 

[mrBrown]

Du kannst aus der OpenAPI-/Swagger-Definition alle nötigen Klassen generieren lassen.

Annotationen brauchst du nur in Sonderfällen, üblicherweise funktioniert das mit einfachen Attributen ohne Probleme.

 

[beta20]

Du kannst aus der OpenAPI-/Swagger-Definition alle nötigen Klassen generieren lassen.

Oh ok, wusste ich nicht - wie mache ich das?

 

[mrBrown]

https://github.com/OpenAPITools/openapi-generator

 

[beta20]

Oh, habe gerade gesehen, das geht auch online. Ist ja richtig nice:
https://editor.swagger.io/