{"id":390,"date":"2014-06-28T17:22:52","date_gmt":"2014-06-28T09:22:52","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=390"},"modified":"2018-12-02T14:08:25","modified_gmt":"2018-12-02T06:08:25","slug":"how-to-send-http-post-requests-with-java-without-using-any-external-libraries","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/how-to-send-http-post-requests-with-java-without-using-any-external-libraries\/","title":{"rendered":"How to send HTTP POST request with Java without using any external libraries"},"content":{"rendered":"

I need to create a Java solution that will be able to send some bulk processing information back to a HTTP server endpoint. The Java solution should be as lean as possible, using as many facilities that Java provides out of the box. Luckily for me, Java do provides the java.net.HttpURLConnection<\/code> class for me to build my solution. This post details a proof of concept which I did to get to know more about the java.net.HttpURLConnection<\/code> class. <\/p>\n

In this proof of concept, I create a Java console program that will hit the php endpoint which I had created earlier to proof that I can use jQuery to push a dynamically generated file to the web browser based on the user\u2019s input<\/a>.<\/p>\n

Defining the server endpoint with the java.net.URL class<\/h3>\n

I first create an instance of the java.net.URL<\/code> class, passing it the url of the server endpoint which will process my HTTP request.<\/p>\n

\r\nURL serverUrl = \r\n    new URL("https:\/\/www.techcoil.com\/process\/proof-of-concepts\/userNameAndLuckyNumberTextFileGeneration");\r\n<\/pre>\n
Getting an instance of java.net.HttpURLConnection object to send a HTTP request to the server and receive a HTTP response from the server<\/h3>\n
After I had defined the server endpoint to send my HTTP request, I call the open<\/code> method of the URL<\/code> object:<\/p>\n
\r\nHttpURLConnection urlConnection = (HttpURLConnection)serverUrl.openConnection();\r\n<\/pre>\n
I can then use the HttpURLConnection<\/code> facilities via urlConnection<\/code> to send the HTTP request to my server endpoint and read the HTTP response from it.<\/p>\n
Preparing the HTTP request to send to the server endpoint<\/h3>\n
Once I have the HttpURLConnection<\/code> object, I can write the following codes to construct the HTTP request to send to the server endpoint:<\/p>\n
\r\n\/\/ Indicate that we want to write to the HTTP request body\r\nurlConnection.setDoOutput(true);\r\nurlConnection.setRequestMethod("POST");\r\n\r\n\/\/ Writing the post data to the HTTP request body\r\nBufferedWriter httpRequestBodyWriter = new BufferedWriter(new OutputStreamWriter(urlConnection.getOutputStream()));\r\nhttpRequestBodyWriter.write("visitorName=Johnny+Jacobs&luckyNumber=1234");\r\nhttpRequestBodyWriter.close();\r\n<\/pre>\n
By default, the HttpURLConnection<\/code> object does not allow me to write to the HTTP request body. As such, I first configure the HttpURLConnection<\/code> object to allow me to write to the HTTP request body by calling urlConnection.setDoOutput(true)<\/code>. I then call urlConnection.setRequestMethod(\"POST\")<\/code> to indicate the request method as HTTP post.<\/p>\n
After I had configured the HttpURLConnection<\/code> object, I layered the output stream to a java.io.BufferedWriter<\/code> object. This allows me to write an encoded string to the HTTP request body. The encoded string sets \"Johnny Jacobs\" to the visitorName<\/code> post variable and \"1234\" to the luckyNumber<\/code> post variable.  <\/p>\n
Reading from the HTTP response from the server endpoint<\/h3>\n
The HTTP request will be sent to the server endpoint when my code starts to read from urlConnection<\/code>. To read the HTTP response from the server endpoint, I wrote the following codes: <\/p>\n
\r\n\/\/ Reading from the HTTP response body\r\nScanner httpResponseScanner = new Scanner(urlConnection.getInputStream());\r\nwhile(httpResponseScanner.hasNextLine()) {\r\n\tSystem.out.println(httpResponseScanner.nextLine());\r\n}\r\nhttpResponseScanner.close();\r\n<\/pre>\n
I layered the input stream of urlConnection<\/code> to a java.util.Scanner<\/code> object. This allows me to read the HTTP response body that the server sends back to me. I then use the Scanner<\/code> object to read the response body and write to console, line by line.<\/p>\n
A simple console application that sends a HTTP POST request to a server endpoint at Techcoil<\/h3>\n
The following sums up the points that are mentioned in this post:<\/p>\n
\r\nimport java.io.BufferedWriter;\r\nimport java.io.IOException;\r\nimport java.io.OutputStreamWriter;\r\nimport java.net.HttpURLConnection;\r\nimport java.net.URL;\r\nimport java.util.Scanner;\r\n\r\n\r\npublic class Program {\r\n\r\n    public static void main(String[] args) throws IOException{\r\n\r\n    \/\/ Define the server endpoint to send the HTTP request to\r\n\tURL serverUrl = \r\n    new URL("https:\/\/www.techcoil.com\/process\/proof-of-concepts\/userNameAndLuckyNumberTextFileGeneration");\r\n\tHttpURLConnection urlConnection = (HttpURLConnection)serverUrl.openConnection();\r\n\r\n\t\/\/ Indicate that we want to write to the HTTP request body\r\n\turlConnection.setDoOutput(true);\r\n\turlConnection.setRequestMethod("POST");\r\n\r\n\t\/\/ Writing the post data to the HTTP request body\r\n\tBufferedWriter httpRequestBodyWriter = \r\n            new BufferedWriter(new OutputStreamWriter(urlConnection.getOutputStream()));\r\n\thttpRequestBodyWriter.write("visitorName=Johnny+Jacobs&luckyNumber=1234");\r\n\thttpRequestBodyWriter.close();\r\n\r\n\t\/\/ Reading from the HTTP response body\r\n\tScanner httpResponseScanner = new Scanner(urlConnection.getInputStream());\r\n\twhile(httpResponseScanner.hasNextLine()) {\r\n\t\tSystem.out.println(httpResponseScanner.nextLine());\r\n\t}\r\n\thttpResponseScanner.close();\r\n\r\n    }\r\n}\r\n<\/pre>\n
Any instances of java.io.IOException will be shown in the console screen. With that, I concluded my proof of concept of sending a HTTP POST request to a server endpoint with the facilities that Java provides me with.<\/p>\n\n