{"id":1599,"date":"2018-01-19T19:23:02","date_gmt":"2018-01-19T19:23:02","guid":{"rendered":"http:\/\/goofy-trucks.flywheelsites.com\/adobe-flash-builder-4-data-centric-features-for-php-page-2\/"},"modified":"2018-01-19T19:24:55","modified_gmt":"2018-01-19T19:24:55","slug":"adobe-flash-builder-4-data-centric-features-for-php-page-2","status":"publish","type":"post","link":"https:\/\/phpbuilder.com\/adobe-flash-builder-4-data-centric-features-for-php-page-2\/","title":{"rendered":"Adobe Flash Builder 4: Data-centric Features for PHP Page 2"},"content":{"rendered":"
\n
\n
By PHP Builder Staff<\/div>\n
on June 8, 2009<\/div>\n<\/p><\/div>\n
\n
\n

Coding the Service<\/h2>\n<\/div>\n
Make sure that the PHP service
\nthat was generated is currently selected in the main window.
\nIf you are working in the full version of Flash Builder
\nwithout having installed a PHP editing plug-in, Flash
\nBuilder opens the generated service with a different
\napplication on your computer (most likely Adobe Dreamweaver,
\nif it is installed on your local machine; otherwise, it
\ndefaults to the application that is associated with the PHP
\nfile format). <\/div>\n
The PHP class that was generated
\nfor you is a stub for basic Create, Replace, Update, and
\nDelete (CRUD) operations that are typically part of a remote
\nservice. Uncomment the code within the operations of the
\nclass. You can use this code as a template for your
\nservices, or remove the code entirely and create the code
\nfor the operations from scratch. However, if this is your
\nfirst time testing the new data-centric features of Flash
\nBuilder, I strongly recommend sticking with the stub code
\nfor now. The service class used for this article was only
\nslightly modified: Basically, I replaced
\nitem<\/strong> with user<\/strong> wherever it
\nappeared. You will also need to change the database
\nparameters accordingly as well as table names and fields
\nwhere they appear so that they correspond with your actual
\ndatabase. The application built in this article pulls
\ncontact information from a table called
\nUser<\/strong>, so I had to modify the service stub
\naccordingly. <\/div>\n
When you are finished coding the
\nservice, you must configure the return types for each
\noperation. However, before you do that, this is a good time
\nto open the package that was added to the Package Explorer
\nfor your project earlier. The package is named
\nservices.UserService<\/em><\/strong>,<\/em>
\nwhere UserService<\/em><\/strong> is the name that
\nyou assigned to your service. <\/strong>In this
\npackage, you will find two classes. The one that holds the
\nsame name as your PHP service that is intended for
\ncustomization. Notice that the class extends your service’s
\nsuper class. The name of the super class will have
\n_Super_ <\/strong>attached to the beginning of the
\nservice name. Do not modify this class. You can override any
\nof the methods in the super class as necessary. <\/div>\n
\nConfiguring Return Types\n<\/div>\n
Your Flash application must know
\nwhat to expect for the data type that will be sent and
\nreturned for each method. To configure your method return
\ntypes, right-click one of the operations from the
\nData\/Services<\/strong> tab, then click
\nConfigure Return Type<\/strong>.\n<\/div>\n
This process can be a bit tricky
\nif you aren’t aware of a few things. First, it is best to
\nconfigure the getAllUsers<\/code> method first.
\nAssuming that your service does not have any errors, you
\nshould get a response with an object that has more objects
\nin the payload, provided that you inserted a few entries
\ninto your database for testing purposes. Next, enter a name,
\nsuch as User<\/strong>, as shown in Figure 6. <\/div>\n

\n
\n

Click here for larger image<\/em><\/font><\/a>
\nFigure 6\n<\/p>\n<\/p>\n

This is the new process for
\ncreating value objects. You can still code value objects the
\nway you did with Flex Builder, but it would be
\ncounterintuitive to use the same methodology with Flash
\nBuilder, considering the speedier workflow you gain by
\nletting Flash Builder automate this process for you. Plus,
\nthe value objects that Flash Builder generates are more like
\nvalue objects on steroids, in that they do a whole lot more
\nthan just wrap a bunch of values for strong data typing
\nbetween the client and server. For example, the return type
\nset for getAllItems<\/code> is a User<\/code>
\nobject, even though it is actually a collection of
\nUser<\/code> objects. This is because the auto-
\ngenerated result handlers are smart enough to know the
\ndifference between a single User<\/code> object that is
\nreturned versus a collection of User<\/code> objects.
\nIn other words, you don’t have to type the result to an
\nArrayCollection<\/code> and go through the whole
\ntyping, binding, and object-mapping process as you would
\nhave done with Flex Builder. <\/div>\n
When configuring the
\ngetAllUsers<\/code> and getUsers_paged<\/code>
\nmethods, you’ll have to shift the paradigm that you may have
\ngotten used to with previous versions of Flex. In the past,
\nyou would have declared an ArrayCollection<\/code>,
\ntyped the response data to it, and then bound your list or
\ndata grid to the variable. There were also things like class
\nmapping, which made the process even more difficult.
\nLuckily, that’s all in the past. <\/div>\n
So, the code that was generated
\nwhen your value object was created is smart enough to figure
\nout when it has a collection of User objects as opposed to a
\nsingle User object. Therefore, as you can see in Figure 7,
\nthe return types for getAllUsers<\/code>,
\ngetUser<\/code>, and getUsers_paged<\/code> are
\nall of type User<\/code>. <\/div>\n

\n
\n

Click here for larger image<\/em><\/font><\/a>
\nFigure 7
\n<\/p>\n

When you configure the
\nupdateUser<\/code> operation, you could send the ID and
\nuser details as a single object or two separate objects’ it
\nreally doesn’t matter. The main thing to understand is that
\nyou are not sending a User<\/code> object here. The PHP
\nservice does not care about the strongly typed
\nUser<\/code> object you have on the client side, nor
\ndoes it need to. Just send the data as an Object, as seen in
\nFigure 8. <\/div>\n


\n

Click here for larger image<\/em><\/font><\/a>
\nFigure 8\n<\/p>\n<\/p>\n

The reasoning for sending the new
\nuser data over as a generic Object is clear upon reviewing
\nthe Structured Query Language (SQL) statement that was auto-
\ngenerated for the PHP service stub: <\/div>\n


\npublic function updateUser($userId, $user) {
\n\u00a0\u00a0$this->connect();
\n\u00a0\u00a0$sql = \"UPDATE User SET last_name = '$user->last_name', first_name = '$user->first_name',

\n\u00a0\u00a0email = '$user->email', phone = '$user->phone', company = '$user->company', job_title =
\n\u00a0\u00a0'$user->job_title', person_type = '$user->person_type', lead_source = '$user->lead_source',
\n\u00a0\u00a0tags = '$user->tags' WHERE id = $userId->id\";
\n\u00a0\u00a0mysqli_query($this->connection, $sql)
\n\u00a0\u00a0or die('Query failed: ' . mysqli_error($this->connection));
\n\u00a0\u00a0\u00a0\u00a0mysqli_close($this->connection);
\n}
\n<\/code><\/p>\n<\/div>\n

<\/p>\n

\n
\u00ab Previous Page<\/a><\/div>\n
1<\/a> <\/div>\n
| <\/div>\n
2<\/div>\n
| <\/div>\n
3<\/a> <\/div>\n
| <\/div>\n
4<\/a> <\/div>\n
Next Page \u00bb<\/a><\/div>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"

Learn how to take advantage of the new data-centric features of Flash Builder to increase your workflow<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-1599","post","type-post","status-publish","format-standard","hentry","category-tutorials"],"_links":{"self":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts\/1599","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/comments?post=1599"}],"version-history":[{"count":1,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts\/1599\/revisions"}],"predecessor-version":[{"id":2317,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/posts\/1599\/revisions\/2317"}],"wp:attachment":[{"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/media?parent=1599"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/categories?post=1599"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/phpbuilder.com\/wp-json\/wp\/v2\/tags?post=1599"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}