Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member

ColdFusion 9 New Features

From: ColdFusion 9 New Features

Video: Saving objects to the database

Pulling records out of the database is fun enough, but nothing really gets done, unless you can save data back to the database. In this video I am going to show you some gotchas with the way ColdFusion 9 and Hibernate save records. I am going to show you how to properly manage when changes you have made to your objects actually get saved. So to start, let's make sure that everything is still set up correctly for our ORM. In Application.cfc, we should have ORM enabled. Our cfcs are going to be in the cfcs directory and we have our SQL logging turned on.

Saving objects to the database

Pulling records out of the database is fun enough, but nothing really gets done, unless you can save data back to the database. In this video I am going to show you some gotchas with the way ColdFusion 9 and Hibernate save records. I am going to show you how to properly manage when changes you have made to your objects actually get saved. So to start, let's make sure that everything is still set up correctly for our ORM. In Application.cfc, we should have ORM enabled. Our cfcs are going to be in the cfcs directory and we have our SQL logging turned on.

Open up savingrecords.cfm. All we are doing is pulling one record out of the database and dumping it back to the screen. So to make things easier to see exactly what's going on with our SQL, I am going to dropout both the left and the right- hand columns. Then I am going to move the Console up here to the upper right and collapse this bottom section. Now, I can see my code on the left and all the SQL that's getting run on the right. If I preview the file, we can see all of the hibernate SQL getting executed.

So, now that we know that's working, let's clear out the console and change our object. I will go over here and change this artist's name, set the first name to Dan. Now, in any ColdFusion 8 application, once you have changed an object you have to do something to make it save. You can call a save method. You write an update statement on the database. You perform some action that makes the application save that record. With ColdFusion 9 and Hibernate, things work a little differently.

If I preview this file, we can see that not only I did a select run, but an update ran as well. Even though I did nothing to tell the record to save. The reason this happens is because Hibernate creates an ORM session. What that means is at the beginning of a request, a session begins in Hibernate that keeps track of every change made to every object in your request. At the end of that request, all changes are flushed, which we means Hibernate checks them all and does all the work that it thinks it needs to do. But for me, this doesn't quite work.

I don't want everything updated at the end of the request. I want to have control over when records get written to the database. So, I know that they only get written when they are supposed to. To change that in the Application. cfc, we can add another setting here, called flushatrequestend. If we set that value to false, ColdFusion will never automatically flush the ORM session from hibernate. So if we go back to our savingrecords. cfm, I am going to clear the console again and reload my page.

We can now see that only the slect ran. So how I do get records to save? If we switch back over to Source view, I just have to add one function, cfset ORMFlush. This will tell Hibernate to take every change that's been written to objects so far and write it to the database. So let's clear the console once more and preview our file. Now what happened here is that the change still didn't show up. Well, the last time we loaded this file, we updated the name to Dan.

In this case, we are still updating the name to Dan, so nothing actually changed on the record. The record is not dirty, so Hibernate isn't going to save it. If we go back to our Source view and change this artist's name back to Aiden and then preview our file, now we can see that the select and the update ran. So what if for some reason I want to back out my changes? If I don't want to save this record to the database, I can evict the record from the ORM session. To evict the record from the ORM session, we first have to get our session.

So we use the ORMGetSession function and then call the Evict method and then I just have to tell it which object in the current session I want to evict. In this case, I am telling it to kick the artist out of the ORM session, so it doesn't get saved. Let's go ahead and change the first name this time to Ben. Now, well we can make sure that the object does indeed become "dirty" and we can make sure that it gets evicted from the session. Let's clear the console over here once more and then preview our file.

We can see that the first select was run, but there was no update. However, if we look over here on the code side, I can still see the object state still shows the first name Ben, but it was never saved back to the database. So now you know how to update records and cancel an update for a record. Now let's go over creating new records. Go back to our Source view. Let's comment out this first section. So to create a new record, I am going say cfset Artist = EntityNew and I will tell it I want a new copy of an artist.

Then I am going to do Artist.setArtistID. Because the Artist IDs in this particular database aren't auto-numbered, I have to enter in my own ID. If the database had an auto-number field for the ID, you wouldn't need to mess with this. Next, we'll set the Firstname to Dan, and we will set the Lastname to Short. Now, let's clear the console and see what happens when we preview our file. You will notice the no SQL was run at all.

When you insert a new record, you have to explicitly tell ColdFusion that you want it to save the record. So if we go back to our source, we need to call EntitySave and then I pass it the object I want to save and then call ORMFlush in order to get it to write the insert to the database. If I go and preview my file, we now see that there is an initial select to make sure that that record doesn't exist and then an insert is run. So you should now have a grasp of some of the hidden pitfalls of using ColdFusion 9's new ORM features when you are saving data.

Just be mindful of how and when you are saving data to make sure that you don't save something you shouldn't have and that all data is validated before pushing it into the database.

Show transcript

This video is part of

Image for ColdFusion 9 New Features
ColdFusion 9 New Features

36 video lessons · 2996 viewers

Daniel Short
Author

 
Expand all | Collapse all
  1. 4m 30s
    1. Welcome
      53s
    2. Using the exercise files
      3m 37s
  2. 7m 48s
    1. Adding managing and comparing servers
      5m 26s
    2. Monitoring server health
      2m 22s
  3. 22m 10s
    1. Setting the default data source and SMTP
      5m 6s
    2. Getting programmatic debugging and exception handling
      5m 54s
    3. Reviewing the new onCFCRequest method
      5m 29s
    4. Using ApplicationStop()
      2m 24s
    5. Working with Server.cfc and onServerStart
      3m 17s
  4. 17m 45s
    1. Using ternary and chained operations
      5m 46s
    2. Using New and Import
      4m 2s
    3. Reviewing CFScript enhancements
      7m 57s
  5. 20m 23s
    1. Building with implicit getters and setters
      4m 26s
    2. Working with LOCAL scope in functions
      4m 35s
    3. Serializing objects
      6m 6s
    4. Writing components in CFScript
      5m 16s
  6. 19m 27s
    1. Getting started with ORM
      5m 51s
    2. Logging ORM activity
      2m 13s
    3. Saving objects to the database
      6m 10s
    4. Defining table relationships
      5m 13s
  7. 16m 59s
    1. Caching page fragments
      5m 29s
    2. Managing the cache
      4m 48s
    3. Working with in-memory files using VFS (RAM disks)
      6m 42s
  8. 12m 39s
    1. Working with Excel spreadsheets
      4m 56s
    2. Working with Word documents
      4m 4s
    3. Working with PowerPoint presentations
      3m 39s
  9. 28m 58s
    1. Loading Google maps with markers onto a page
      4m 53s
    2. Adding a Flash movie with the built-in FLV player
      2m 14s
    3. Using multi-file upload control
      6m 7s
    4. Building a progress indicator
      3m 37s
    5. Working with accordion layouts
      3m 18s
    6. Showing information with data grid enhancements
      5m 1s
    7. Informing users with Confirm Alert and Prompt dialog boxes
      3m 48s
  10. 9m 8s
    1. Accessing IMAP accounts
      6m 31s
    2. Working with the new array functions
      2m 37s
  11. 15s
    1. Goodbye
      15s

Start learning today

Get unlimited access to all courses for just $25/month.

Become a member
Sometimes @lynda teaches me how to use a program and sometimes Lynda.com changes my life forever. @JosefShutter
@lynda lynda.com is an absolute life saver when it comes to learning todays software. Definitely recommend it! #higherlearning @Michael_Caraway
@lynda The best thing online! Your database of courses is great! To the mark and very helpful. Thanks! @ru22more
Got to create something yesterday I never thought I could do. #thanks @lynda @Ngventurella
I really do love @lynda as a learning platform. Never stop learning and developing, it’s probably our greatest gift as a species! @soundslikedavid
@lynda just subscribed to lynda.com all I can say its brilliant join now trust me @ButchSamurai
@lynda is an awesome resource. The membership is priceless if you take advantage of it. @diabetic_techie
One of the best decision I made this year. Buy a 1yr subscription to @lynda @cybercaptive
guys lynda.com (@lynda) is the best. So far I’ve learned Java, principles of OO programming, and now learning about MS project @lucasmitchell
Signed back up to @lynda dot com. I’ve missed it!! Proper geeking out right now! #timetolearn #geek @JayGodbold
Share a link to this course

What are exercise files?

Exercise files are the same files the author uses in the course. Save time by downloading the author's files instead of setting up your own files, and learn by following along with the instructor.

Can I take this course without the exercise files?

Yes! If you decide you would like the exercise files later, you can upgrade to a premium account any time.

Become a member Download sample files See plans and pricing

Please wait... please wait ...
Upgrade to get access to exercise files.

Exercise files video

How to use exercise files.

Learn by watching, listening, and doing, Exercise files are the same files the author uses in the course, so you can download them and follow along Premium memberships include access to all exercise files in the library.


Exercise files

Exercise files video

How to use exercise files.

For additional information on downloading and using exercise files, watch our instructional video or read the instructions in the FAQ .

This course includes free exercise files, so you can practice while you watch the course. To access all the exercise files in our library, become a Premium Member.

Join now Already a member? Log in

Are you sure you want to mark all the videos in this course as unwatched?

This will not affect your course history, your reports, or your certificates of completion for this course.


Mark all as unwatched Cancel

Congratulations

You have completed ColdFusion 9 New Features.

Return to your organization's learning portal to continue training, or close this page.


OK
Become a member to add this course to a playlist

Join today and get unlimited access to the entire library of video courses—and create as many playlists as you like.

Get started

Already a member ?

Become a member to like this course.

Join today and get unlimited access to the entire library of video courses.

Get started

Already a member?

Exercise files

Learn by watching, listening, and doing! Exercise files are the same files the author uses in the course, so you can download them and follow along. Exercise files are available with all Premium memberships. Learn more

Get started

Already a Premium member?

Exercise files video

How to use exercise files.

Ask a question

Thanks for contacting us.
You’ll hear from our Customer Service team within 24 hours.

Please enter the text shown below:

The classic layout automatically defaults to the latest Flash Player.

To choose a different player, hold the cursor over your name at the top right of any lynda.com page and choose Site preferences from the dropdown menu.

Continue to classic layout Stay on new layout
Exercise files

Access exercise files from a button right under the course name.

Mark videos as unwatched

Remove icons showing you already watched videos if you want to start over.

Control your viewing experience

Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.

Interactive transcripts

Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.

Learn more, save more. Upgrade today!

Get our Annual Premium Membership at our best savings yet.

Upgrade to our Annual Premium Membership today and get even more value from your lynda.com subscription:

“In a way, I feel like you are rooting for me. Like you are really invested in my experience, and want me to get as much out of these courses as possible this is the best place to start on your journey to learning new material.”— Nadine H.

Thanks for signing up.

We’ll send you a confirmation email shortly.


Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

Keep up with news, tips, and latest courses with emails from lynda.com.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

   
submit Lightbox submit clicked
Terms and conditions of use

We've updated our terms and conditions (now called terms of service).Go
Review and accept our updated terms of service.