Au REPOS du ressort et de la méthode de PATCH

J'ai remarqué que beaucoup de réponses sont toutes JSON de correction ou incomplète des réponses. Ci-dessous une explication complète et exemple de ce que vous avez besoin avec le fonctionnement du monde réel code

Tout d'abord, le PATCH est sélectif MIS. Vous pouvez l'utiliser pour mettre à jour un certain nombre de domaines pour un objet ou une liste d'objets. Dans un METTRE vous envoient généralement l'ensemble de l'objet avec toutes les mises à jour.

PATCH /objet/7

{
   "objId":7,
   "objName": "New name"
}

METTRE /objet/7

{
   "objId":7,
   "objName": "New name",
   "objectUpdates": true,
   "objectStatus": "ongoing",
   "scoring": null,
   "objectChildren":[
       {
          "childId": 1
       },
     ............ 
}

Cela vous permet de mettre à jour des enregistrements, sans d'énormes quantités de points de terminaison. Par exemple, ci-dessus, pour la mise à jour de notation vous avez besoin de l'objet/{id}/notation, puis de mettre à jour nom de l'objet/{id}/nom. Littéralement, d'un point de terminaison pour chaque article, ou vous avez besoin de l'extrémité avant de publier la totalité de l'objet à chaque mise à jour. Si vous avez un énorme objet, ce qui peut prendre beaucoup de temps réseau ou de données mobiles qui est inutile. Le patch vous permet d'avoir 1 point de terminaison avec le minimum de propriété de l'objet qui envoie une plate-forme mobile à utiliser.

voici un exemple d'une utilisation dans le monde réel pour le patch:

@ApiOperation(value = "Patch an existing claim with partial update")
@RequestMapping(value = CLAIMS_V1 + "/{claimId}", method = RequestMethod.PATCH)
ResponseEntity<Claim> patchClaim(@PathVariable Long claimId, @RequestBody Map<String, Object> fields) {

    //Sanitize and validate the data
    if (claimId <= 0 || fields == null || fields.isEmpty() || !fields.get("claimId").equals(claimId)){
        return new ResponseEntity<>(HttpStatus.BAD_REQUEST); //400 Invalid claim object received or invalid id or id does not match object
    }

    Claim claim = claimService.get(claimId);

    //Does the object exist?
    if( claim == null){
        return new ResponseEntity<>(HttpStatus.NOT_FOUND); //404 Claim object does not exist
    }

    //Remove id from request, we don't ever want to change the id.
    //This is not necessary, you can just do it to save time on the reflection
    //loop used below since we checked the id above
    fields.remove("claimId");

    fields.forEach((k, v) -> {
        //use reflection to get field k on object and set it to value v
        //Change Claim.class to whatver your object is: Object.class
        Field field = ReflectionUtils.findField(Claim.class, k); //find field in the object class
        field.setAccessible(true); 
        ReflectionUtils.setField(field, claim, v); //set given field for defined object to value V
    });

    claimService.saveOrUpdate(claim);
    return new ResponseEntity<>(claim, HttpStatus.OK);
}

Ci-dessus peut être source de confusion pour certaines personnes que de nouveaux devs n'ont pas l'habitude de traiter avec une réflexion comme ça. Fondamentalement, tout ce que vous passer de cette fonction dans le corps, il va trouver de l'allégation connexe à l'aide de l'ID donné, puis mettre à jour UNIQUEMENT les champs que vous passer en tant que valeur de la clé de la paire.

Exemple corps:

PATCH /sinistres/7

{
   "claimId":7,
   "claimTypeId": 1,
   "claimStatus": null
}

La ci-dessus sera mise à jour claimTypeId et claimStatus pour les valeurs données pour la revendication 7, laissant toutes les autres valeurs intactes.

De sorte que le retour serait quelque chose comme:

{
   "claimId": 7,
   "claimSrcAcctId": 12345678,
   "claimTypeId": 1,
   "claimDescription": "The vehicle is damaged beyond repair",
   "claimDateSubmitted": "2019-01-11 17:43:43",
   "claimStatus": null,
   "claimDateUpdated": "2019-04-09 13:43:07",
   "claimAcctAddress": "123 Sesame St, Charlotte, NC 28282",
   "claimContactName": "Steve Smith",
   "claimContactPhone": "777-555-1111",
   "claimContactEmail": "[email protected]",
   "claimWitness": true,
   "claimWitnessFirstName": "Stan",
   "claimWitnessLastName": "Smith",
   "claimWitnessPhone": "777-777-7777",
   "claimDate": "2019-01-11 17:43:43",
   "claimDateEnd": "2019-01-11 12:43:43",
   "claimInvestigation": null,
   "scoring": null
}

Comme vous pouvez le voir, l'intégralité de l'objet serait de revenir sans modification de toutes les données autres que ce que vous voulez changer. Je sais qu'il y est un peu de la répétition dans l'explication ici, je voulais juste décrire clairement.

Créer un reste modèle à l'aide de -

import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;

RestTemplate rest = new RestTemplate(new HttpComponentsClientHttpRequestFactory());
now make the PATCH call
        ResponseEntity<Map<String, Object>> response = rest.exchange(api, HttpMethod.PATCH, request, 
            responseType);