What are the advantages and disadvantages of using the PUT method in HTTP requests?

The PUT method in HTTP is used to replace a resource at a specified URI or to create it if it does not exist.

Advantages:

• Idempotency: repeated PUT requests with the same data do not further change the server state.
• Clear definition of updating or creating a resource.

Disadvantages:

• Requires sending the full representation of the resource, even if only part of it changes.
• Not always suitable for partial updates (for this, PATCH is better).

Example of using PUT:

HttpURLConnection connection = (HttpURLConnection) new URL("https://api.example.com/resource/1").openConnection();
connection.setRequestMethod("PUT");
connection.setDoOutput(true);
try(OutputStream os = connection.getOutputStream()) {
    byte[] input = "{\"name\":\"New Name\"}".getBytes("utf-8");
    os.write(input, 0, input.length);
}
int responseCode = connection.getResponseCode();