[system] / trunk / pg / lib / Applet.pm Repository:
ViewVC logotype

View of /trunk/pg/lib/Applet.pm

Parent Directory Parent Directory | Revision Log Revision Log


Revision 5619 - (download) (as text) (annotate)
Sun Mar 16 14:39:39 2008 UTC (11 years, 7 months ago) by gage
File size: 19460 byte(s)
New version of Applet.pm and AppletObjects.pl that supports both flashnew FlashApplet();
and java applets
new JavaApplet();

see pod docs in those two files for more details.

    1 ################################################################################
    2 # WeBWorK Online Homework Delivery System
    3 # Copyright  2000-2007 The WeBWorK Project, http://openwebwork.sf.net/
    4 # $CVSHeader: pg/lib/Applet.pm,v 1.4 2007/12/20 00:04:39 gage Exp $
    5 #
    6 # This program is free software; you can redistribute it and/or modify it under
    7 # the terms of either: (a) the GNU General Public License as published by the
    8 # Free Software Foundation; either version 2, or (at your option) any later
    9 # version, or (b) the "Artistic License" which comes with this package.
   10 #
   11 # This program is distributed in the hope that it will be useful, but WITHOUT
   12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
   13 # FOR A PARTICULAR PURPOSE.  See either the GNU General Public License or the
   14 # Artistic License for more details.
   15 ################################################################################
   16 
   17 =head1 NAME
   18 
   19 Applet.pl - Provides code for inserting FlashApplets and JavaApplets into webwork problems
   20 
   21 =head1 SYNPOSIS
   22 
   23   ###################################
   24   # Create  link to applet
   25   ###################################
   26   my $appletName = "LineThruPointsWW";
   27   $applet = new FlashApplet(
   28      # can be replaced by $applet =FlashApplet() when using AppletObjects.pl
   29      codebase   => findAppletCodebase("$appletName.swf"),
   30      appletName => $appletName,
   31      appletId   => $appletName,
   32      submitActionAlias => 'checkAnswer',
   33   );
   34 
   35   ###################################
   36   # Configure applet
   37   ###################################
   38 
   39   #xml data to set up the problem-rac
   40   $applet->state(qq{<XML>
   41   <point xval='$xval_1' yval='$yval_1' />
   42   <point xval='$xval_2' yval='$yval_2' />
   43   </XML>});
   44 
   45 
   46   ###################################
   47   # insert applet header material
   48   ###################################
   49   HEADER_TEXT($applet->insertHeader );
   50 
   51   ###################################
   52   # Text section
   53   #
   54 
   55   ###################################
   56   #insert applet into body
   57   ###################################
   58   TEXT( MODES(TeX=>'object code', HTML=>$applet->insertObject));
   59 
   60 
   61 =head1 DESCRIPTION
   62 
   63 This file provides an object to store in one place
   64 all of the information needed to call an applet.
   65 
   66 The object FlashApplet has defaults for inserting flash applets.
   67 
   68 =over
   69 
   70 =item *
   71 
   72 =item *
   73 
   74 =back
   75 
   76 (not yet completed)
   77 
   78 The module JavaApplet has defaults for inserting java applets.
   79 
   80 The module Applet stores common code for the two types of applet.
   81 
   82 =head1 USAGE
   83 
   84 These modules are activate by listing it in the modules section of global.conf and rebooting the server.
   85 The companion file to this one is macros/AppletObjects.pl
   86 
   87 qw(Applet FlashApplet JavaApplet)
   88 
   89 =cut
   90 
   91 
   92 
   93 package Applet;
   94 
   95 
   96 
   97 
   98 
   99 use MIME::Base64 qw( encode_base64 decode_base64);
  100 
  101 
  102 =head2 Default javaScript functions placed in header
  103 
  104 These functions are automatically defined for use for
  105 any javaScript placed in the text of a PG question.
  106 
  107   getApplet(appletName)  -- finds the applet path in the DOM
  108 
  109   submitAction()            -- calls the submit action of the applets
  110 
  111 
  112     initializeAction()        -- calls the initialize action of the applets
  113 
  114     getQE(name)               -- gets an HTML element of the question by name
  115                                  or by id.  Be sure to keep all names and ids
  116                                  unique within a given PG question.
  117 
  118     getQuestionElement(name)  -- long form of getQE(name)
  119 
  120     listQuestionElements()    -- for discovering the names of inputs in the
  121                                  PG question.  An alert dialog will list all
  122                                  of the elements.
  123              Usage: Place this at the END of the question,
  124              just before END_DOCUMENT():
  125 
  126               TEXT(qq!<script> listQuestionElements() </script>!);
  127         ENDDOCUMENT();
  128 
  129     list of  accessor methods  format:  current_value = $self->method(new_value or empty)
  130 
  131     appletId         for simplicity and reliability appletId and appletName are always the same
  132     appletName
  133 
  134     archive      the name of the .jar file containing the applet code
  135     code         the name of the applet code in the .jar archive
  136     codebase     a prefix url used to find the archive and the applet itself
  137 
  138     height       rectangle alloted in the html page for displaying the applet
  139     width
  140 
  141     params       an anonymous array containing name/value pairs
  142                  to configure the applet [name =>'value, ...]
  143 
  144     header       stores the text to be added to the header section of the html page
  145         object       stores the text which places the applet on the html page
  146 
  147     debug        in debug mode several alerts mark progress through the procedure of calling the applet
  148 
  149     config       configuration are those customizable attributes of the applet which don't
  150                  change as it is used.  When stored in hidden answer fields
  151                  it is usually stored in base64 encoded format.
  152     base64_config base64 encode version of the contents of config
  153 
  154     configAlias  (default: config ) names the applet command called with the contents of $self->config
  155                  to configure the applet.  The parameters are passed to the applet in plain text using <xml>
  156                  The outer tags must be   <xml> .....   </xml>
  157     state        state consists of those customizable attributes of the applet which change
  158                  as the applet is used.  It is stored by the calling .pg question so that
  159                  when revisiting the question the applet
  160                  will be restored to the same state it was left in when the question was last
  161                  viewed.
  162 
  163     getStateAlias  (default: getState) alias for command called to read the current state of the applet.
  164                    The state is passed in plain text xml format with outer tags: <xml>....</xml>
  165     setStateAlias  (default: setState) alias for the command called to reset the  state of the applet.
  166                    The state is passed in plain text in xml format with outer tags: <xml>....</xml>
  167 
  168     base64_state   returns the base64 encoded version of the state stored in the applet object.
  169 
  170     initializeActionAlias  -- (default: initializeAction) the name of the javaScript subroutine called to initialize the applet (some overlap with config/ and setState
  171         submitActionAlias      -- (default: submitAction)the name of the javaScript subroutine called when the submit button of the
  172                                   .pg question is pressed.
  173 
  174     returnFieldName
  175 
  176 
  177 
  178 
  179 
  180 =cut
  181 
  182 
  183 
  184 
  185 sub new {
  186    my $class = shift;
  187    my $self = {
  188     appletName =>'',
  189     code=>'',
  190     codebase=>'',
  191 #   appletId  =>'',   #always use identical applet Id's and applet Names
  192     params    =>undef,
  193     width     => 550,
  194     height    => 400,
  195     base64_state       =>  '',
  196     base64_config      =>  '',
  197     getStateAlias      =>  'getXML',
  198     setStateAlias      =>  'setState',
  199     configAlias        =>  'config',
  200     initializeActionAlias => 'setXML',
  201     submitActionAlias  =>  'getXML',
  202     returnFieldName    =>  'receivedField',
  203     headerText         =>  DEFAULT_HEADER_TEXT(),
  204     objectText         => '',
  205     debug              => 0,
  206     @_,
  207   };
  208   bless $self, $class;
  209   return $self;
  210 }
  211 
  212 sub  header {
  213   my $self = shift;
  214   if ($_[0] eq "reset") {  # $applet->header('reset');  erases default header text.
  215     $self->{headerText}='';
  216   } else {
  217     $self->{headerText} .= join("",@_);  # $applet->header(new_text); concatenates new_text to existing header.
  218   }
  219     $self->{headerText};
  220 }
  221 sub  object {
  222   my $self = shift;
  223   if ($_[0] eq "reset") {
  224     $self->{objectText}='';
  225   } else {
  226     $self->{objectText} .= join("",@_);
  227   }
  228     $self->{objectText};
  229 }
  230 sub params {
  231   my $self = shift;
  232   if (ref($_[0]) =~/HASH/) {
  233     $self->{params} = shift;
  234   } elsif ( !defined($_[0]) or $_[0] =~ '') {
  235     # do nothing (read)
  236   } else {
  237     warn "You must enter a reference to a hash for the parameter list";
  238   }
  239   $self->{params};
  240 }
  241 
  242 sub initializeActionAlias {
  243   my $self = shift;
  244   $self->{initializeActionAlias} = shift ||$self->{initializeActionAlias}; # replace the current contents if non-empty
  245     $self->{initializeActionAlias};
  246 }
  247 
  248 sub submitActionAlias {
  249   my $self = shift;
  250   $self->{submitActionAlias} = shift ||$self->{submitActionAlias}; # replace the current contents if non-empty
  251     $self->{submitActionAlias};
  252 }
  253 sub getStateAlias {
  254   my $self = shift;
  255   $self->{getStateAlias} = shift ||$self->{getStateAlias}; # replace the current contents if non-empty
  256     $self->{getStateAlias};
  257 }
  258 
  259 sub setStateAlias {
  260   my $self = shift;
  261   $self->{setStateAlias} = shift ||$self->{setStateAlias}; # replace the current contents if non-empty
  262     $self->{setStateAlias};
  263 }
  264 sub configAlias {
  265   my $self = shift;
  266   $self->{configAlias} = shift ||$self->{configAlias}; # replace the current contents if non-empty
  267     $self->{configAlias};
  268 }
  269 sub returnFieldName {
  270   my $self = shift;
  271   $self->{returnFieldName} = shift ||$self->{returnFieldName}; # replace the current contents if non-empty
  272     $self->{returnFieldName};
  273 }
  274 sub codebase {
  275   my $self = shift;
  276   $self->{codebase} = shift ||$self->{codebase}; # replace the current codebase if non-empty
  277     $self->{codebase};
  278 }
  279 sub code {
  280   my $self = shift;
  281   $self->{code} = shift ||$self->{code}; # replace the current code if non-empty
  282     $self->{code};
  283 }
  284 sub height {
  285   my $self = shift;
  286   $self->{height} = shift ||$self->{height}; # replace the current height if non-empty
  287     $self->{height};
  288 }
  289 sub width {
  290   my $self = shift;
  291   $self->{width} = shift ||$self->{width}; # replace the current width if non-empty
  292     $self->{width};
  293 }
  294 sub archive {
  295   my $self = shift;
  296   $self->{archive} = shift ||$self->{archive}; # replace the current archive if non-empty
  297     $self->{archive};
  298 }
  299 sub appletName {
  300   my $self = shift;
  301   $self->{appletName} = shift ||$self->{appletName}; # replace the current appletName if non-empty
  302     $self->{appletName};
  303 }
  304 sub debug {
  305   my $self = shift;
  306   my $new_flag = shift;
  307   $self->{debug} = $new_flag if defined($new_flag);
  308   $self->{debug};
  309 }
  310 sub appletId {
  311   appletName(@_);
  312 }
  313 sub state {
  314   my $self = shift;
  315   my $str = shift;
  316   $self->{base64_state} =  encode_base64($str)   ||$self->{base64_state}; # replace the current string if non-empty
  317   $self->{base64_state} =~ s/\n//g;
  318     decode_base64($self->{base64_state});
  319 }
  320 
  321 sub base64_state{
  322   my $self = shift;
  323   $self->{base64_state} = shift ||$self->{base64_state}; # replace the current string if non-empty
  324     $self->{base64_state};
  325 }
  326 sub config {
  327   my $self = shift;
  328   my $str = shift;
  329   $self->{base64_config} =  encode_base64($str)   || $self->{base64_config}; # replace the current string if non-empty
  330   $self->{base64_config} =~ s/\n//g;
  331     decode_base64($self->{base64_config});
  332 }
  333 sub base64_config {
  334   my $self = shift;
  335   $self->{base64_config} = shift ||$self->{base64_config}; # replace the current string if non-empty
  336   $self->{base64_config} =$self->{base64_config};
  337     $self->{base64_config};
  338 }
  339 #FIXME
  340 # need to be able to adjust header material
  341 
  342 sub insertHeader {
  343     my $self = shift;
  344     my $codebase         = $self->codebase;
  345     my $appletId         = $self->appletId;
  346     my $appletName       = $self->appletName;
  347     my $base64_initialState     = $self->base64_state;
  348     my $initializeAction = $self->initializeActionAlias;
  349     my $submitAction     = $self->submitActionAlias;
  350     my $setState         =  $self->setStateAlias;
  351     my $getState         =  $self->getStateAlias;
  352     my $config           =  $self->configAlias;
  353     my $base64_config    =  $self->base64_config;
  354     my $debugMode        =  ($self->debug) ? "1": "0";
  355     my $returnFieldName  = $self->{returnFieldName};
  356 #    my $encodeStateQ     = ($self->debug)?'' : "state = Base64.encode(state);";              # in debug mode base64 encoding is not used.
  357 #     my $decodeStateQ = "if (!state.match(/<XML>*/i) ) {state = Base64.decode(state)}";   # decode if <XML> is not present
  358     my $headerText       = $self->header();
  359     $headerText =~ s/(\$\w+)/$1/gee;   # interpolate variables p17 of Cookbook
  360 
  361     return $headerText;
  362 
  363 
  364 }
  365 
  366 sub insertObject {
  367     my $self       = shift;
  368     my $code       = $self->{code};
  369     my $codebase   = $self->{codebase};
  370     my $appletId   = $self->{appletName};
  371     my $appletName = $self->{appletName};
  372     my $archive    = $self->{archive};
  373     my $width      = $self->{width};
  374     my $height     = $self->{height};
  375     my $parameters = '';
  376     my $parameters = '';
  377     my %param_hash = %{$self->params()};
  378     foreach my $key (keys %param_hash) {
  379       $parameters .= qq!<param name ="$key"  value = "$param_hash{$key}">\n!
  380     }
  381 
  382     $objectText = $self->{objectText};
  383     $objectText =~ s/(\$\w+)/$1/gee;
  384     return $objectText;
  385 }
  386 sub initialize  {
  387     my $self = shift;
  388   return q{
  389     <script>
  390       initializeAction();
  391       // this should really be done in the <body> tag
  392     </script>
  393   };
  394 
  395 }
  396 
  397 
  398 use constant DEFAULT_HEADER_TEXT =><<'END_HEADER_SCRIPT';
  399 
  400   <script language="JavaScript">
  401   var debug = $debugMode;
  402   //
  403   //CONFIGURATIONS
  404   //
  405     // configurations are "permanent"
  406     applet_config_list["$appletName"]   = function() {
  407         if (debug) { alert("configure $appletName . $config ( $base64_config )");}
  408       try {
  409           if (debug || !( typeof(getApplet("$appletName").$config)  == "undefined" ) ) {
  410 
  411           getApplet("$appletName").$config(Base64.decode("$base64_config"));
  412         }
  413       } catch(e) {
  414         alert("error executing configuration command $config for $appletName: " + e );
  415       }
  416     }
  417     //
  418     //STATE
  419     //
  420     // state can vary as the applet is manipulated.
  421     applet_setState_list["$appletName"] = function(state) {
  422         state =  state || getQE("$appletName"+"_state").value || "<xml></xml>";
  423           if ( base64Q(state) ) { state=Base64.decode(state);}
  424           if (debug) { alert("set state for $appletName to " + state);}
  425       try {
  426         if (debug || !( typeof(getApplet("$appletName").$setState)  =="undefined" ) ) {
  427           getApplet("$appletName").$setState( state );
  428         }
  429       } catch(e) {
  430         alert("Error in setting state of $appletName: " + e );
  431       }
  432   };
  433   applet_getState_list["$appletName"] = function () {
  434       if (debug) { alert("getState for applet $appletName");}
  435       try {
  436         var applet = getApplet("$appletName");
  437         var state;
  438         if (!( typeof(getApplet("$appletName").$getState)  =="undefined" ) ) {
  439           state  = applet.$getState();               // get state in xml format
  440         }
  441         if (!debug) {state = Base64.encode(state) };   // replace state by encoded version
  442         getQE("$appletName"+"_state").value = state;   //place in state htmlItem (debug: textarea, otherwise hidden)
  443       } catch (e) {
  444         alert("Error in getting state for $appletName " + e );
  445       }
  446     };
  447     //
  448     //INITIALIZE
  449     //
  450     applet_initializeAction_list["$appletName"] = function () {
  451           applet_setState_list["$appletName"]();
  452   };
  453 
  454   applet_submitAction_list["$appletName"] = function () {
  455           applet_getState_list["$appletName"]();
  456       getQE("$returnFieldName").value = getApplet("$appletName").sendData();
  457     };
  458     </script>
  459 
  460 END_HEADER_SCRIPT
  461 
  462 package FlashApplet;
  463 @ISA = qw(Applet);
  464 
  465 
  466 
  467 =pod
  468 
  469 The secret to making this applet work with IE in addition to normal browsers
  470 is the addition of the C(<form></form>) construct just before the object.
  471 
  472 For some reason IE has trouble locating a flash object which is contained
  473 within a form.  Adding this second blank form with the larger problemMainForm
  474 seems to solve the problem.
  475 
  476 This follows method2 of the advice given in url(http://kb.adobe.com/selfservice/viewContent.do?externalId=kb400730&sliceId=2)
  477 Method1 and methods involving SWFObject(Geoff Stearns) and SWFFormFix (Steve Kamerman) have yet to be fully investigated:
  478 http://devel.teratechnologies.net/swfformfix/swfobject_swfformfix_source.js
  479 http://www.teratechnologies.net/stevekamerman/index.php?m=01&y=07&entry=entry070101-033933
  480 
  481     use constant DEFAULT_OBJECT_TEXT =><<'END_OBJECT_TEXT';
  482       <form></form>
  483       <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
  484            id="$appletName" width="500" height="375"
  485            codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
  486          <param name="movie" value="$codebase/$appletName.swf" />
  487          <param name="quality" value="high" />
  488          <param name="bgcolor" value="#869ca7" />
  489          <param name="allowScriptAccess" value="sameDomain" />
  490          <embed src="$codebase/$appletName.swf" quality="high" bgcolor="#869ca7"
  491            width="$width" height="$height" name="$appletName" align="middle" id="$appletName"
  492            play="true" loop="false" quality="high" allowScriptAccess="sameDomain"
  493            type="application/x-shockwave-flash"
  494            pluginspage="http://www.macromedia.com/go/getflashplayer">
  495          </embed>
  496 
  497        </object>
  498     END_OBJECT_TEXT
  499 
  500 
  501 =cut
  502 
  503 use constant DEFAULT_OBJECT_TEXT =><<'END_OBJECT_TEXT';
  504   <form></form>
  505   <object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
  506              id="$appletName" width="500" height="375"
  507              codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
  508          <param name="movie" value="$codebase/$appletName.swf" />
  509          <param name="quality" value="high" />
  510          <param name="bgcolor" value="#869ca7" />
  511          <param name="allowScriptAccess" value="sameDomain" />
  512          <embed src="$codebase/$appletName.swf" quality="high" bgcolor="#869ca7"
  513              width="$width" height="$height" name="$appletName" align="middle" id="$appletName"
  514              play="true" loop="false" quality="high" allowScriptAccess="sameDomain"
  515              type="application/x-shockwave-flash"
  516              pluginspage="http://www.macromedia.com/go/getflashplayer">
  517          </embed>
  518 
  519      </object>
  520 END_OBJECT_TEXT
  521 
  522 sub new {
  523     my $class = shift;
  524   $class -> SUPER::new( objectText   => DEFAULT_OBJECT_TEXT(),
  525                   @_
  526   );
  527 
  528 }
  529 
  530 
  531 package JavaApplet;
  532 @ISA = qw(Applet);
  533 
  534 
  535 
  536 =pod
  537 
  538 The secret to making this applet work with IE in addition to normal browsers
  539 is the addition of the C(<form></form>) construct just before the object.
  540 
  541 For some reason IE has trouble locating a flash object which is contained
  542 within a form.  Adding this second blank form with the larger problemMainForm
  543 seems to solve the problem.
  544 
  545 This follows method2 of the advice given in url(http://kb.adobe.com/selfservice/viewContent.do?externalId=kb400730&sliceId=2)
  546 Method1 and methods involving SWFObject(Geoff Stearns) and SWFFormFix (Steve Kamerman) have yet to be fully investigated:
  547 http://devel.teratechnologies.net/swfformfix/swfobject_swfformfix_source.js
  548 http://www.teratechnologies.net/stevekamerman/index.php?m=01&y=07&entry=entry070101-033933
  549 
  550     use constant DEFAULT_OBJECT_TEXT =><<'END_OBJECT_TEXT';
  551       <form></form>
  552      <applet
  553       code     = "$code"
  554       codebase = "$codebase"
  555       archive  = "$archive"
  556       name     = "$appletName"
  557       id       = "$appletName"
  558       width    = "$width"
  559       height   = "$height"
  560       MAYSCRIPT
  561      >
  562       $parameters
  563      </applet>
  564     END_OBJECT_TEXT
  565 
  566 =cut
  567 
  568 use constant DEFAULT_OBJECT_TEXT =><<'END_OBJECT_TEXT';
  569   <form></form>
  570  <applet
  571   code     = "$code"
  572   codebase = "$codebase"
  573   archive  = "$archive"
  574   name     = "$appletName"
  575     id       = "$appletName"
  576     width    = "$width"
  577     height   = "$height"
  578     MAYSCRIPT
  579  >
  580   $parameters
  581  </applet>
  582 END_OBJECT_TEXT
  583 
  584 sub new {
  585     my $class = shift;
  586   $class -> SUPER::new( objectText   => DEFAULT_OBJECT_TEXT(),
  587                   @_
  588   );
  589 
  590 }
  591 
  592 
  593 
  594 1;

aubreyja at gmail dot com
ViewVC Help
Powered by ViewVC 1.0.9