Changes between Version 22 and Version 23 of BossaExampleOne

Timestamp:

Jul 30, 2008, 10:51:30 AM (17 years ago)

Author:

davea

Comment:

--

BossaExampleOne

@@ -19 +19 @@
  * '''ops/bossa_example_make_files.php''': a script that creates image files.
  * '''ops/bossa_example_make_jobs.php''': a script that creates jobs.
- * '''inc/bossa_example.inc''': the display and policy functions.
+ * '''inc/bossa_example.inc''': the application's callback functions.
 
 We'll go through these scripts and explain how they work.
@@ -50 +50 @@
 and collects them into a "batch".
 
-== Display and policy functions ==
+== Callback functions ==
 
 The file ([source:/trunk/boinc/html/inc/bossa_example.inc html/inc/bossa_example.inc])
-contains display and policy functions.
+contains the application's callback functions.
+
 The display function is:
 {{{
      9  function job_show($job, $inst, $user) {
-    10      $info = $job->get_info($job);
+    10      $info = $job->get_opaque_data($job);
     11      $path = $info->path;
     12      page_head("Find the Ellipse");
@@ -75 +76 @@
 }}}
 
-It calls a Bossa API function to get the job's opaque data (line 9).
+This calls a Bossa API function to get the job's opaque data (line 10).
 Then it generates a web page containing the image
 within a form, so that clicking on the image (or on the None button)
 will invoke '''bossa_job_finished.php'''.
-
-The policy functions are as follows.
 
 {{{
@@ -89 +88 @@
 
 This is called when a job is issued.
-It sets the job's priority to zero so that no further instances will be issued
-(unless this one times) out.
+It sets the job's priority to zero so that no other instances will be issued
+until further notice.
 
 {{{
@@ -106 +105 @@
 }}}
 
-This is called when a job instance is finished.
+This is called when an instance is finished.
 It gets the user's response to the job,
-and stores it in the instance's app data field.
+and stores it as the instance's opaque data.
 
 {{{
@@ -120 +119 @@
 
 The remaining functions return short strings
-that show the app data for jobs, instances, and users on the Admin page:
+that summarize the opaque data for jobs, instances, and users on the Admin page:
 {{{
 function job_summary($job) {
-    $info = $job->get_info();
+    $info = $job->get_opaque_data();
     return "<a href=".URL_BASE."$info->path>View image</a>";
 }
 
 function instance_summary($inst) {
-    $info = $inst->get_info();
+    $info = $inst->get_opaque_data();
     if ($info->have_ellipse) {
         return "($info->cx, $info->cy)";