Save Initial Image with airSlate SignNow

Save initial image

in this video we're going to see a simple way to upload an image in spring but--and actually it's really any file but we're going to use an image as a sample so what we need is something called multi-part file and then path paths and file which come from a newer package in Java Java 1-7 Java dot in i/o is the package also we need to consider how to deal with exceptions so without further ado let's get started I'm in our development environment now what we're going to do is we're going to add a new form to the start page where user can upload an image I have the start page open in Eclipse and what we'll do is right down here I'll just say a new form and we'll say method equals post now in the world of micro-services post typically means we're creating something new now as a matter of fact we notice I'm adding a new form after an existing form that I have and eventually I'm going to combine these two forms together but just to keep things simple right now I'm going to keep them separate when I do combine them together I'm going to change the method type of the form to posts because get and microservices really means we're reading something post means we're creating something new so little divergence there but nonetheless that's where we're going to go now we have to say Inc type I haven't used this one before Inc type equals and then we're going to say double quote oh I already have the double quote so we'll say multi-part slash and on a US keyboard that's the slash on the question mark key form - data and then action equals and then we'll give it a new end point of upload image and we'll go ahead and close off this form and I'm going to copy this upload image into my buffer because I know I'm going to need this or to my clipboard because I know I'm going to need that on the controller side when I add the endpoint mapping to the controller so inside of this will say input type equals file that will say name equals and we can call this one image file or we could just call it file if we want doesn't really matter okay after that we're going to say input type equals submit and then we'll say value E Bulls upload or you could call it upload image whatever you like and then of course terminate the tag goes we normally would so that's all we need for a simple form the next thing we're going to do is pop into our controller and handle this in point now we're in our controller scroll to the bottom and let's just get this a simple method we'll save public string upload image open and close paren open curly closed curly now let's map this to our post mapping endpoint so we use post mapping which is a shortcut for request mapping with method equals post and inside of this I do double quote double quote and inside of that I simply paste the upload image in point that we grabbed from that form and copied into our buffer just a moment ago now I don't like red lines so let's go ahead and say string return value equals double quote double quote and then return return value and that will take care of a red line for our missing return statement now comes the tricky part what we need to do is we need to capture that information that is submitted to us from our page so looks like the field is called image file so let's capture that will say multi-part file image file but we need to do a little bit more magic here first of all a ctrl shift all organized imports and bring in that multi-part file and now we need to map this with the request purim annotation so at request for RAM and we'll simply say double quote image file just like so and close double quote and I think we're good at this point so what we need to do next is we need to save the file so we already have our specimen service referenced here we pulled that in way up above let's take a look so you see specimen service on line 35 so we are have that already Auto wired so I'm going to say specimen service dot save and let's pass in this image file now the save method does not exist let's say let's call it save image or save photo save image will be consistent so save like sale now this method does not yet exist we're kind of drawing it out proactively let's see what happens when I put my mouse over that control one and let's go ahead and say create method and interface I specimen Dao so we're making this up now now we know that saving an image is going to require that we're doing something outside of the virtual machine in other words we're accessing the file system anytime we do something outside the virtual machine there's a risk that things can go wrong and that's typically when we need to deal with exceptions so I'm going to go ahead and say throws exception on the signature reason being can the service do anything if the save went wrong limited probably not a whole lot but the you I can at least log and inform the user so we'll go ahead and say save image and now you notice as soon as I do that that my specimen service no longer compiles because we have changed the contract in the interface but this is an easy fix a simple control one whoops a simple control one will allow us to implement those methods so control one and a dumb implemented methods and there we go we're also going to need to take care of our stub which is something that we made a while ago as a matter of fact at this point we probably don't really need the stub anymore so it might even be safe to take that away but let's go ahead and fill in what we're doing here so save image for this I'm going to go to I'll tell you what I eventually want to make a separate photo Dao not gonna worry about that in this video because I just want to quickly show how to upload an image so right now I'm going to go ahead and save the image but eventually we'll come back and refactor this we'll have the service layer call down to a Dao okay so we'll go ahead take away that to do because we're going to start doing and now we'll say string folder equals and then slash again slash on the question mark key on the US keyboard slash photos and then slash and then out next we're going to say image whoops we'll say toga but we'll put down here image file dot get bytes so get the raw data from this file and that will be saved into a byte array so control one here if you want sometimes it makes it easier a signed statement a new local variable or you can type that all out you see I just had Eclipse do a little bit of work for me okay so we have a folder where we're going to save the image and we have the byte stream that represents the image the next thing that we need to do is we need to assemble the location where we want to store the image for that we use something called paths which is a newer class in Java one seven so pants get and inside of that will say folder plus and then fire image file whoops make that the right case that get original file name so in other words what's the file name that the user uploaded we might want to rename this ourselves again in a future refactor we can do that we might want to rename this so we don't end up with IMG zero zero one jpg which one persons over writes another person's or temp one jpg where that's going to be a common image name but nonetheless we'll trust that it's going to be relatively unique right now once again we can mouse over get control one and we can say assign statement to new local variable and that will give us a path where we can store the file finally we use files dot right again files as a newer class in Java one seven and we simply say the path that we provided the byte array at this point not worried about options one note is that we need this path to already exist we could put some code in here to create it but for our simple example why don't we just go ahead and create the path and you see I'm using the slash and then photos which kind of says start at root and then find the photos directory so I'll go out to my virtual machine C Drive and I'm simply going to make a new folder called photos so our success criteria here is I should be able to upload a photo and I should see it in that photos directory so a couple things we will start the oh you know what I oh yeah that's right sorry I need to handle my exception here so I'm going to surround with try-catch and we'll say log dot error because we know that any time we have a catch block we should really at the very least do some logging so error saving photo comma and then we'll use our e our exception variable will pass into that and we'll also return change the return value to a ler now at this time we're simply doing a bit of debugging so my normal return value will just go right back to the start screen nothing crazy there so at this point we should have enough to go ahead and debug I'm going to save make sure I know I need to change one more thing which is my specimen service stub that's because the interface change this is not so important we'll go ahead and add the unimplemented methods that's a class we're not really using anymore anyway so as if we could make an argument that we could go ahead and remove that from our project but nonetheless we should be in fairly good shape now so I'll restart our server and we'll give it a go okay the server's now restarted you and I just paused the video for a moment so I could download a simple image but nonetheless service restarted and you see now we have the choose file option in the upload button so let me go ahead and choose file and I will grab this redbud that I photographed in Cleveland so just about the right size image so we'll grab the redbud there and choose upload now what we really want to see is we want to walk through this in the debugger and we also want to verify our success criteria and that is that we see this image in that photos directory so I choose upload the break point stops that's naturally a good sign we say go ahead and switch and specimen service save image we can see now this is interesting we can see that this image file that we're receiving in this endpoint does have the name plane places image two zero one seven zero nine zero six one three two seven four one which is the correct name of that file so it looks like we did indeed get the file uploaded from browser to server now one important note is that III added a caching annotation earlier that introduced a bit of aspect oriented programming which means there's something that intercepts are call going from controller to our specimen so it's not so easy to hit the step into because that gets in that AOP stuff unrelated to this video and I don't want to confuse the video so what I'm going to do is from the controller now I'm going to hit play and we get a little bit of funkiness here and that's again related to the AOP you probably won't have that if you haven't done the caching annotation but nonetheless everything's fine because look where it picks up next it picks up on our specimen service so let's go ahead and step over this one line at a time we see we have the folder we have the byte array for our image and finally with any luck we have the path we mouse over the path and we see it's / photos / plant places image lalala let's double check that photos directory and confirm that nothing's in there yet and there's not anything in there now I'm going to go ahead and step over and for good luck let's press play and let's go back and voila look at what we have so sure enough this is not the image that I originally downloaded but instead this is the image that I've uploaded using aspect-oriented programming and if you've ever been to Cleveland before you might recognize where this is this is on public square right in middle of downtown Cleveland a Red Bud common tree to find in the Ohio area so at this point we've successfully uploaded an image what we need to do in our next video is display this image to the user and also in some following videos we want to record this photo and associate it with the specimen that we're creating don't worry about the Sarah page that's you know that's just the default return but nonetheless we want to display the image to the user sorry we want to associate that image with whatever specimen the user is entering here that way is a user I can manually enter the details of a specific plant that I have in my yard latitude longitude description and the plant name we know is an autocomplete that we put together earlier even though I still have a breakpoint on that and then we can add several images to that and we can say that these images belong to this specimen so we'll do that wiring up in a few future videos I look forward to seeing you then and I look forward to reading your comments thank you