Schneimi’s Dev Weblog


Behaviors on model associations

Posted in CakePHP by schneimi on the September 6, 2009
Tags: , , , ,

I made a simple behavior that serializes (beforeSave) and deserializes (afterFind) data to and from the database.

The behavior works fine as long as I do a find directly over the model where my behavior is attached, but if I do a find through associated models using the containable behavior, my behavior is not triggered at all and I have to deserialize the data manually after the find, which is very uncomfortable.

Model behavior afterFind is triggered

$this->Model->find(...);

Model behavior afterFind isn’t triggered

$this->OtherModel->contain('Model');
$this->OtherModel->find(...);

I found a ticket and a thread concerning this topic, and it turns out that this is an existing problem with CakePHP for a longer time already.

Because I use the latest CakePHP 1.2.5 and couldn’t find any working patch for it, I adapted the patch found in the thread to this version. I am not very familiar with the core, so it’s still quick&dirty and I cannot tell if it works for every setup. Anyway I hope this still helps other people that run into the same problem.

Here are the changes that have to be done in the cake\libs\model\datasources\dbo_source.php, just place the code after the lines:

Line 877: $resultSet[$i][$association] = $linkModel->afterFind($resultSet[$i][$association]);

foreach ($linkModel->Behaviors->attached() as $behavior) {
  if ($behavior != 'Containable') {
    $data = array(array($association => $resultSet[$i][$association]));
    $filtered_data = $linkModel->Behaviors->{$behavior}->afterFind($linkModel, $data, false);

    if ($filtered_data) {
      $resultSet[$i][$association] = $filtered_data[0][$association];
    }
  }
}

Line 741: function queryAssociation(&$model, &$linkModel, $type, $association, $assocData, &$queryData, $external = false, &$resultSet, $recursive, $stack) {

foreach ($linkModel->Behaviors->attached() as $behavior) {
  if ($behavior != 'Containable') {
    $return = $linkModel->Behaviors->{$behavior}->beforeFind($linkModel, $assocData);
    $assocData = (is_array($return)) ? $return : $assocData;
  }
}

Line 716: $data = $model->{$className}->afterFind(array(array($className => $results[$i][$className])), false);

foreach ($model->{$className}->Behaviors->attached() as $behavior) {
  if ($behavior != 'Containable') {
    $filtered_data = $model->{$className}->Behaviors->{$behavior}->afterFind($model->{$className}, $data, false);

    if ($filtered_data) {
      $data = $filtered_data;
    }
  }
}

edit:
I added support for the beforeFind callback, because I needed this on a softdelete behavior to filter associated deleted data as well.

I also found out that you don’t have to really hack the core, instead just copy the cake\libs\model\datasources\dbo_source.php into your app app\models\datasources\dbo_source.php and change this file instead.

Fast random find with CakePHP

Posted in CakePHP by schneimi on the August 28, 2009
Tags: , , ,

I want to share my experience with random finds in CakePHP because they can be very slow done the wrong way.

In this example we have the model Audioplaylist which hasAndBelongsToMany Audio and we want to get a random playlist of Audios. We assume the table for Audio is pretty large and we also need the data of other related models as result, let’s say the owner’s username and the title of the related album. All models are set to $recursive = -1 and the ContainableBehavior is used to contain the data.

  • The first approach would be to make one find and get all the data at once.
  • $audios = $this->Audioplaylist->Audio->find('all', array('contain' => array('User.name',
                                                                                'Album.title'),
                                                             'order' => 'RAND()',
                                                             'limit' => $count));
    

    Happy waiting!

    You have to know that DB queries ordered by RAND() get slower the more fields are selected, and in this case we even select all fields of the Audio model.

  • Knowing that, we can improve the find in using the fields parameter to also contain the fields of the Audio model.
  • $audios = $this->Audioplaylist->Audio->find('all', array('contain' => array('User.name',
                                                                                'Album.title'),
                                                             'fields' => 'id',
                                                             'order' => 'RAND()',
                                                             'limit' => $count));
    

    This is already a lot faster than before, but still not very applicable because it still slows down with the amount of related data.

  • So let’s try another approach that looks more circumstantial but avoids the problem seen before. The idea is to make two finds, the first one just finds some random Audio Ids and the second will then use the Ids to catch all the related data.
  • $randomAudioIds = $this->Audioplaylist->Audio->find('list', array('fields' => 'id',
                                                                      'order' => 'RAND()',
                                                                      'limit' => $count));
    
    $audios = $this->Audioplaylist->Audio->find('all', array('contain' => array('User.name',
                                                                                'Album.title'),
                                                             'conditions' => array('Audio.id' => $randomAudioIds),
                                                             'order' => 'RAND()'));
    

    Sometimes more is less, especially if you need alot of data from related models, you will appreciate the performance of these two queries.

    Star rating plugin for CakePHP

    Posted in Ajax, CakePHP by schneimi on the May 25, 2009
    Tags: , , , , , ,

    In the google groups I recently noticed the lack of a star rating helper/plugin for CakePHP.

    As I just implemented an AJAX rating system for my current project and always wanted to learn the CakePHP plugin system, I thought this was a good opportunity to make my code into a plugin and contribute to the community.

    My rating system supports multiple users and multiple models, so you can let people rate any model you want.

    I tried to keep it simple and flexible, but I am sure there is still much room for improvements. So let me know what you think about it, any suggestions and comments are welcome.

    Here is the plugin v2.2 to download.

    This article can also be found in the Bakery now.

    Features

    • Multi user, multi model rating
    • Just one element to place in your views
    • Seamless integration with AJAX
    • Prototype and jQuery support
    • Cross browser compatibility
    • Fallback for disabled javascript
    • Various configurations

    Requirements

    • CakePHP 1.2
    • Prototype or jQuery javascript framework
    • User id stored in session for secure rating

    Demonstration
    A demo can be tested and downloaded at
    http://ratingdemo.schneimi.spacequadrat.de/

      Installation and Use

      • Make sure you meet the requirements above. Make sure you meet the requirements above. For the download and integration of a javascript framework, please visit the Prototype or jQuery website.
        • Extract the plugin, including the subfolder ‘rating’, to your app plugins folder ‘app/plugins‘.
          • Copy the ‘rating/config/plugin.rating.php’ to your app configs folder ‘app/config’ and change the settings to your desire. It is recommended to let ‘Rating.showHelp’ set to true until everything works.
            • Apply the ‘install.sql’ to your database to create the ratings table.
              CREATE TABLE `ratings` (
                `id` int(11) unsigned NOT NULL auto_increment,
                `user_id` char(36) NOT NULL default '',
                `model_id` char(36) NOT NULL default '',
                `model` varchar(100) NOT NULL default '',
                `rating` tinyint(2) unsigned NOT NULL default '0',
                `name` varchar(100) default '',
                `created` datetime default NULL,
                `modified` datetime default NULL,
                PRIMARY KEY (`id`),
                KEY `rating` (`model_id`,`model`,`rating`,`name`)
              );
              
            • Load the plugin javascript and css files in your layout file. Replace [your_framework] with prototype_min or jquery_min depending on the framework you use.
                <?php echo $javascript->link('/rating/js/[your_framework]'); ?>
                <?php echo $html->css('/rating/css/rating'); ?>
                
            • For full model integration in your app, apply the following relation to your models. (replace [name_of_your_model])
                var $hasMany = array('Rating' =>
                                     array('className'   => 'Rating',
                                           'foreignKey'  => 'model_id',
                                           'conditions' => array('model' => '[name_of_your_model]'),
                                           'dependent'   => true,
                                           'exclusive'   => true
                                     )
                               );  
            • If you set ‘Rating.saveToModel’ to true, then add the defined ‘Rating.modelAverageField’ and ‘Rating.modelVotesField’ to all models you want to rate. To do that you can use the following SQL statements (replace [your_table] and [Rating.modelAverageField]).
              ALTER TABLE [your_table] ADD (`[Rating.modelAverageField]` decimal(3,1) unsigned default '0.0');
              ALTER TABLE [your_table] ADD (`[Rating.modelVotesField]` int(11) unsigned default '0');

              If the plugin shows the fields are still missing, try to clear the model cache of your app at ‘app/tmp/cache/models’.

            • You can change the styles of the rating element in the css file ‘rating/vendors/css/rating.css’.
              • Finally you can place the rating element in your views as follows. (replace [name_of_your_model] and [id_of_your_model])

                Default rating element for one model id

                  echo $this->element('rating', array('plugin' => 'rating',
                                                      'model' => '[name_of_your_model]',
                                                      'id' => [id_of_your_model]));
                 

                More ratings for one model id
                If you want to have different ratings for one model id like sound and picture of a movie, you can use the additional name parameter.

                  echo $this->element('rating', array('plugin' => 'rating',
                                                      'model' => '[name_of_your_model]',
                                                      'id' => [id_of_your_model],
                                                      'name' => 'sound'));
                
                  echo $this->element('rating', array('plugin' => 'rating',
                                                      'model' => '[name_of_your_model]',
                                                      'id' => [id_of_your_model],
                                                      'name' => 'picture'));
                

                Individual configuration of a rating element
                Sometimes you want to use more than one style of rating elements in your app. That can be reached with the ‘config’ parameter and different config files in ‘app/config’. Just clone the original ‘plugin.rating.php’ and give it a different name, which you then pass to the element.

                  // Uses 'plugin.rating.php' in 'app/config'
                  echo $this->element('rating', array('plugin' => 'rating',
                                                      'model' => '[name_of_your_model]',
                                                      'id' => [id_of_your_model]));
                
                  // Uses 'plugin.rating.style1.php' in 'app/config'
                  echo $this->element('rating', array('plugin' => 'rating',
                                                      'model' => '[name_of_your_model]',
                                                      'id' => [id_of_your_model],
                                                      'config' => 'plugin.rating.style1'));
                
                  // Uses 'plugin.rating.style2.php' in 'app/config'
                  echo $this->element('rating', array('plugin' => 'rating',
                                                      'model' => '[name_of_your_model]',
                                                      'id' => [id_of_your_model],
                                                      'config' => 'plugin.rating.style2'));
                

              Speed-up your website with one click in eclipse

              Posted in CSS, Eclipse, JS by schneimi on the April 30, 2009
              Tags: , , , , , ,

              The most important influence on the loading time of a website, apart from the amount and size of images, is the loading of JS and CSS files.

              This tutorial shows you three approaches to speed up the loading of JS and CSS and how to combine them in a batch script. Finally it shows how to integrate the script in eclipse and to execute it with one click.

              First of all, I will shortly describe the different approaches, before going into detail.

              Consolidation
              During development you need structure and overview, so it is necessary to split the JS and CSS code into different files. But the more files you include in your website, the more network connections have to be set up on loading, which costs unnecessary time and traffic.

              To avoid this problem, the idea is to consolidate all files (of one type) to one file, so that only one connection has to be set up.

              Shrinking
              Shrinking is the removal of all unneeded characters like whitespace and comments in your code. Further the replacement of long variable-names by short ones, which simultaneously obfuscates the code.

              Compression
              To reduce the data being transferred, the webserver can compress it before sending. A receiving webbrowser should be able to recognize the compression and decompress the data.

              The most popular compression for websites is the GZIP compression, which is supported by pretty much all browsers.

              The following steps are for Windows users, but I am sure you can transform them to Linux without much effort!

              1) Consolidation
              The first step is to consolidate your JS and CSS files, so you only have to shrink and compress one file of each type.

              Because JS and CSS includes are globally loaded into the browser, we are able to just glue all files together and include them as one file. A very simple method to achieve that, is the use of the copy command as follows:

              >copy *.css styles_consolidated.css /B
              >copy *.js scripts_consolidated.js /B
              

              The /B does a binary copy and avoids text encoding problems!

              2) Shrinking
              To get rid of unnecessary characters in your code, there are several tools available. As we want to automate the procedure later, we choose the YUI-Compressor which is a great java command line tool that supports JS as well as CSS.

              The only thing we have to do, is to set it on a JS or CSS file to create a shrinked version:

              >java -jar yuicompressor-2.4.1.jar scripts_consolidated.js -o scripts_shrinked.js
              >java -jar yuicompressor-2.4.1.jar styles_consolidated.css -o styles_shrinked.css
              

              If there are any errors in your code, you will get a notice here!

              3) Compression
              There are two ways compression can be applied. You can compress a file once and deposit it, or you can compress a file on-the-fly when transmitting it.

              I use the on-the-fly compression with PHP, because I use PHP anyway and the file is still readable. This is useful during development, where you may want to skip the shrinking for debugging and get useful line numbers in error messages.

              To activate the compression for a file, you just have to make it into a PHP file and add one line of code:

              scripts_shrinked.js.php

              <?php ob_start('ob_gzhandler');header("Content-type: text/javascript; charset: UTF-8"); ?>
              [content of scripts_shrinked.js]
              

              styles_shrinked.css.php

              <?php ob_start('ob_gzhandler');header("Content-type: text/css; charset: UTF-8"); ?>
              [content of styles_shrinked.css]
              

              You include these PHP files like normal JS and CSS files:

              <script type="text/javascript" src="scripts_shrinked.js.php"></script>
              <link rel="stylesheet" type="text/css" href="styles_shrinked.css.php" />
              

              4) Combination
              To combine all three approaches, we will create a little batch script.

              But first, we need to create two PHP files that will be used to apply the GZIP compression to our consolidated and shrinked JS and CSS file.

              gzip_js.php

              <?php ob_start('ob_gzhandler');header("Content-type: text/javascript; charset: UTF-8"); ?>
              

              gzip_css.php

              <?php ob_start('ob_gzhandler');header("Content-type: text/css; charset: UTF-8"); ?>
              

              The following batch script is just an example and is set up for CakePHP and the use in different environments. You have to adapt the paths for individual usage!

              combine.bat

              @echo on
              copy %1\app\vendors\js\protoaculous1.6.packed.js+%1\app\webroot\js\*.js %1\app\webroot\js\scripts_consolidated.js /B
              java -jar %1\app\vendors\yuicompressor-2.4.1.jar %1\app\webroot\js\scripts_consolidated.js -o %1\app\webroot\js\scripts_shrinked.js
              copy %1\app\gzip_js.php+%1\app\webroot\js\scripts_shrinked.js %1\app\webroot\js\scripts.js.php /B /Y
              @echo off
              del %1\app\webroot\js\scripts_consolidated.js
              del %1\app\webroot\js\scripts_shrinked.js
              
              @echo on
              copy %1\app\webroot\css\*.css %1\app\webroot\css\styles_consolidated.css /B
              java -jar %1\app\vendors\yuicompressor-2.4.1.jar %1\app\webroot\css\styles_consolidated.css -o %1\app\webroot\css\styles_shrinked.css
              copy %1\app\gzip_css.php+%1\app\webroot\css\styles_shrinked.css %1\app\webroot\css\styles.css.php /B /Y
              @echo off
              del %1\app\webroot\css\styles_consolidated.css
              del %1\app\webroot\css\styles_shrinked.css
              

              Note that additional files are added with a plus sign!

              Finally, we have to execute the script with the approot as first parameter and let the magic happen:

              >combine.bat [cakePHP approot]
              

              5) Eclipse integration
              Eclipse offers an easy way to integrate external programs and scripts. Here is what you have to do to be able to execute the script with one click:

              1. Open the External Tools Dialog (in submenu of the run-button with red toolbox)
              2. Create a new entry
              3. Enter some name
              4. Enter the location: ${workspace_loc:cake\app\combine.bat}
              5. Enter Arguments: ${workspace_loc:cake}
              6. Choose the “Common” tab
              7. Check “External Tools” under “Display in favorites menu”
              8. Check “Allocate console (necessary for input)” to see the output in the console view

              Now you should be able to select the created external tool and execute it with one click.

              AES 128Bit encryption between Java and PHP

              Posted in Java by schneimi on the November 25, 2008

              Here is how AES encryption works between Java and PHP using the mcrypt module in PHP.

              This is mainly a quick summary of the 4-part tutorial at: http://propaso.com/blog/?cat=6

            • Generate Key in Java
            • String iv = "fedcba9876543210";
              IvParameterSpec ivspec;
              KeyGenerator keygen;
              Key key;
              
              ivspec = new IvParameterSpec(iv.getBytes());
              
              keygen = KeyGenerator.getInstance("AES");
              keygen.init(128);
              key = keygen.generateKey();
              
              keyspec = new SecretKeySpec(key.getEncoded(), "AES");
              
            • Encryption in Java
            • Cipher cipher;
              byte[] encrypted;
              
              cipher = Cipher.getInstance("AES/CBC/NoPadding");
              cipher.init(Cipher.ENCRYPT_MODE, keyspec, ivspec);
              encrypted = cipher.doFinal(padString(text).getBytes());
              
            • Decryption in Java
            • Cipher cipher;
              byte[] decrypted;
              
              cipher = Cipher.getInstance("AES/CBC/NoPadding");
              cipher.init(Cipher.DECRYPT_MODE, keyspec, ivspec);
              decrypted = cipher.doFinal(hexToBytes(code));
              
            • Encryption in PHP
            • function encrypt($str, $key) {
                $key = $this->hex2bin($key);    
              
                $td = mcrypt_module_open("rijndael-128", "", "cbc", "fedcba9876543210");
              
                mcrypt_generic_init($td, $key, CIPHER_IV);
                $encrypted = mcrypt_generic($td, $str);
              
                mcrypt_generic_deinit($td);
                mcrypt_module_close($td);
              
                return bin2hex($encrypted);
              }
              
            • Decryption in PHP
            • function decrypt($code, $key) {
                $key = $this->hex2bin($key);
                $code = $this->hex2bin($code);
              
                $td = mcrypt_module_open("rijndael-128", "", "cbc", "fedcba9876543210");
              
                mcrypt_generic_init($td, $key, CIPHER_IV);
                $decrypted = mdecrypt_generic($td, $code);
              
                mcrypt_generic_deinit($td);
                mcrypt_module_close($td);
              
                return utf8_encode(trim($decrypted));
              }
              
            • Additional functions in Java
            • private byte[] hexToBytes(String hex) {
                String HEXINDEX = "0123456789abcdef";
                int l = hex.length() / 2;
                byte data[] = new byte[l];
                int j = 0;
              
                for (int i = 0; i < l; i++) {
                  char c = hex.charAt(j++);
                  int n, b;
              
                  n = HEXINDEX.indexOf(c);
                  b = (n & 0xf) << 4;
                  c = hex.charAt(j++);
                  n = HEXINDEX.indexOf(c);
                  b += (n & 0xf);
                  data[i] = (byte) b;
                }
              
                return data;
              }
              
              private String padString(String source) {
                char paddingChar = ' ';
                int size = 16;
                int padLength = size - source.length() % size;
              
                for (int i = 0; i < padLength; i++) {
                  source += paddingChar;
                }
              
                return source;
              }
              
            • Additional functions in PHP
            • function hex2bin($hexdata) {
                $bindata = "";
              
                for ($i = 0; $i < strlen($hexdata); $i += 2) {
                  $bindata .= chr(hexdec(substr($hexdata, $i, 2)));
                }
              
                return $bindata;
              }
              

              RSA encryption between Java and PHP

              Posted in Java by schneimi on the November 25, 2008

              This article shows you one way to get RSA encryption working between Java and PHP without any extra libraries or classes, you only need the openssl module activated on PHP side.

              The goal is to encrypt a text with a public key in Java and send the code to PHP where it is decoded with the private key.

              It took me two days and a lot of googling to figure this out, and I hope this will help others not to spend so much time on this topic.

              1) Install and Configure PHP OpenSSL (Windows)

              • php.ini: extension=php_openssl.dll
              • Set environment variable   
                OPENSSL_CONF to C:\Programme\Apache2.2\php\extras\openssl\openssl.cnf
              • Set environment variable   
                PATH to C:\Programme\Apache2.2\php

              2) Generate a private keyfile with PHP

                $keys = openssl_pkey_new();
                $priv = openssl_pkey_get_private($keys);
                openssl_pkey_export_to_file($priv, 'private.pem');
              

              3) Generate a public .der-file from the private keyfile with OpenSSL

              • openssl rsa -in private.pem -pubout -outform DER -out public.der

              4) Import the public key in Java

                File pubKeyFile = new File("public.der");
                DataInputStream dis = new DataInputStream(new FileInputStream(pubKeyFile));
                byte[] keyBytes = new byte[(int) pubKeyFile.length()];
              
                dis.readFully(keyBytes);
                dis.close();
              
                X509EncodedKeySpec keySpec = new X509EncodedKeySpec(keyBytes);
                KeyFactory keyFactory = KeyFactory.getInstance("RSA");
                RSAPublicKey publicKey = (RSAPublicKey)keyFactory.generatePublic(keySpec);
              

              5) Encode the data in Java with the public key

                Cipher cipher = Cipher.getInstance("RSA/ECB/PKCS1PADDING");
                cipher.init(Cipher.ENCRYPT_MODE, publicKey);
                encrypted = cipher.doFinal(text.getBytes());
              

              6) Decode the data with the private key in PHP

                $fp = fopen("private.pem", "r");
                $privateKey = fread($fp, 8192);
                fclose($fp);
              
                $res = openssl_get_privatekey($privateKey);
                openssl_private_decrypt($this->hex2bin($params['cipher']), $decrypted, $res); 
              
                // $decrypted is the result
              
                function hex2bin($hexdata) {
                  $bindata = "";
              
                  for ($i = 0; $i < strlen($hexdata); $i += 2) {
                   $bindata .= chr(hexdec(substr($hexdata, $i, 2)));
                  }
              
                  return $bindata;
                }
              

              7) If you want to decrypt with the public key in PHP as well, you can generate a public.pem file with OpenSSL

              • openssl rsa -in private.pem -out public.pem -outform PEM -puboutr

              Pausing remoteTimer

              Posted in Ajax, CakePHP by schneimi on the November 25, 2008

              This is a simple example on how to create a remoteTimer that can be paused by the user, in this case this is done over a checkbox.

              Because the ajax-Helper offers little help in this case, we need the help of javascript. We also have to simulate pausing with start and stop, because the prototype remoteTimer doesn’t offer it.

              Javascript
              First of all we need a variable to store the timer, in order to be able to stop it later.

              var mytimer = null;
              

              Next we need a function to start the timer with the important parameters.

              function startTimer(url, update, frequency) {
                mytimer = new PeriodicalExecuter(function() {
                    new  Ajax.Updater(update, url , {asynchronous:true, evalScripts:true,
                        requestHeaders:['X-Update', update]})}, frequency);
              }
              

              And for last we need a function to stop the timer.

              function stopTimer() {
                mytimer.stop();
              }
              

              View
              Now we can use the javascript-functions in the view.

              echo $javascript->codeBlock("startTimer('/yourapp/posts/view', 'mydiv', 5)");
              echo $form->checkbox('pause', array('checked' => true,
                'onclick' => "if (this.checked){
                  startTimer('/yourapp/posts/view', 'mydiv', 5);
                } else {
                  stopTimer();
                }"));
              

              VLC like volume control with ajax slider

              Posted in CakePHP, JS by schneimi on the March 13, 2008
              Tags: , , , ,

              I needed a volume control for my site, so I immediately thought of the Ajax slider and easily set up the control. But then I noticed, it looked too much like a timeline and came up with the idea of a VLC like control, where a bar fills up to the selected volume.

              After some experiments, I finally managed to get it working, so here is how it works. The idea is to underlay the track and handle of the slider with a volume bar, that is increased and decreased via javascript on slide (on change). For the volume bar beeing visible through the track, the background of the track is set transparent. The handle will not be visible, so you can click everywhere on the track to set the volume, but you are still able to drag it once you clicked in the track.

              This is how it looks like in two different states. vlc_volume.png

              Here is the HTML/PHP code for the view and the needed CSS and Javascript. I only tested it with Firefox 2.00.12, Opera 9.25 and IE7.

              HTML:

              <div id="volume_control">
                <div id="vol_track">
                  <div id="vol_handle"></div>
                </div>
                <div id="vol_bar"></div>
              </div>
              
              <?php echo $ajax->slider('vol_handle',
                                       'vol_track',
                                       array('range' => '$R(0, 100)',
                                             'sliderValue' => 50,
                                             'increment' => 1,
                                             'onChange' => 'function(vol){setVolume(vol)}',
                                             'onSlide' => 'function(vol){setVolume(vol)}'
                                            )); ?>

              CSS:

              div#volume_control {
                width: 50px;
                height: 16px;
                position: relative;
                background-color: #cccccc;
              }
              
              div#vol_handle {
                width: 0px;
                height: 16px;
                cursor: pointer;
              }
              
              div#vol_track {
                width: 50px;
                height: 16px;
                position: absolute;
                border: 1px inset #fff;
                background-color: transparent;
                cursor: pointer;
                z-index: 2;
              }
              
              div#vol_bar {
                width: 25px;
                height: 16px;
                position: absolute;
                background-color: #1743A7;
                z-index: 1;
              }

              Javascript:

              function setVolume(vol) {
                $('vol_bar').style.width = Math.round(vol/2) + 'px';
              }

              Multiple ajax requests problems and AjaxQueue as solution

              Posted in Ajax, CakePHP by schneimi on the March 10, 2008
              Tags: , , , ,

              For my app I had to load many import processes at once by Ajax requests, so I ran into some serious problems.

              1. Session data was not available each second request
              I used the database option for Sessions, and that seemed to be the problem in this case. Because I don’t worry much about how sessions are saved, I changed it to cake in core.php and it solved this problem, not a really good solution, but I’m fine with it.

              2. Timed out Socket connections
              During the import process I had to make some Socket Connections and however there suddenly was no connection possible anymore after 10-15 requests, so the following ran into timeout.

              3. The solution: AjaxQueue
              After some search and search and search, I finally found a script called AjaxQueue posted on a mailing list. There you can set the maximum amout of simultaneous Ajax requests, exactly what I was looking for. After some testing it turned out to do a really wonderful job and all my problems were solved without loosing much of performance.

              The following code is for the Prototype framework, but it should be no problem to adapt it to other frameworks in replacing the “Ajax.”-statements to similar ones of another framework.

              var AjaxQueue = {
              	batchSize: 1, //No.of simultaneous AJAX requests allowed, Default : 1
              	urlQueue: [], //Request URLs will be pushed into this array
              	elementsQueue: [], //Element IDs of elements to be updated on completion of a request ( as in Ajax.Updater )
              	optionsQueue: [], //Request options will be pushed into this array
              	setBatchSize: function(bSize){ //Method to set a different batch size. Recommended: Set batchSize before making requests
              		this.batchSize = bSize;
              	},
              	push: function(url, options, elementID){ //Push the request in the queue. elementID is optional and required only for Ajax.Updater calls
              		this.urlQueue.push(url);
              		this.optionsQueue.push(options);
              		if(elementID!=null){
              			this.elementsQueue.push(elementID);
              		} else {
              			this.elementsQueue.push("NOTSPECIFIED");
              		}
              
              		this._processNext();
              	},
              	_processNext: function() { // Method for processing the requests in the queue. Private method. Don't call it explicitly
              		if(Ajax.activeRequestCount < AjaxQueue.batchSize) // Check if the currently processing request count is less than batch size
              		{
              			if(AjaxQueue.elementsQueue.first()=="NOTSPECIFIED") { //Check if an elementID was specified
              				// Call Ajax.Request if no ElementID specified
              				//Call Ajax.Request on the first item in the queue and remove it from the queue
              				new Ajax.Request(AjaxQueue.urlQueue.shift(), AjaxQueue.optionsQueue.shift()); 
              
              				var junk = AjaxQueue.elementsQueue.shift();
              			} else {
              				// Call Ajax.Updater if an ElementID was specified.
              				//Call Ajax.Updater on the first item in the queue and remove it from the queue
              				new Ajax.Updater(AjaxQueue.elementsQueue.shift(), AjaxQueue.urlQueue.shift(), AjaxQueue.optionsQueue.shift());
              			}
              		}
              	}
              };
              Ajax.Responders.register({
                //Call AjaxQueue._processNext on completion ( success / failure) of any AJAX call.
                onComplete: AjaxQueue._processNext
              });
              
              /************* SYNTAX ***************
              AjaxQueue.setBatchSize(size);
              
              AjaxQueue.push(URL , OPTIONS, [ElementID]);
              
              ************** USAGE ***************
              AjaxQueue.setBatchSize(4);
              AjaxQueue.push("http://www.testingqueue.com/process/",{onSucess: funcSuccess, onfailure: funcFailure});
              AjaxQueue.push("http://www.testingqueue.com/process1/",{onSucess: funcSuccess1, onfailure: funcFailure1}, "myDiv");
              AjaxQueue.push("http://www.testingqueue.com/process2/",{onSucess: funcSuccess2, onfailure: funcFailure2});
              AjaxQueue.push("http://www.testingqueue.com/process3/",{onSucess: funcSuccess3, onfailure: funcFailure3});
              AjaxQueue.push("http://www.testingqueue.com/process4/",{onSucess: funcSuccess4, onfailure: funcFailure4});
              AjaxQueue.push("http://www.testingqueue.com/process5/",{onSucess: funcSuccess5, onfailure: funcFailure5});
              **********************************/

              Update multiple fields with one ajax request response

              Posted in Ajax, CakePHP by schneimi on the October 27, 2007
              Tags: , , ,

              I searched for a possibility to update multiple fields with each ajax request made by a remoteTimer, but didn’t find any satisfying explanation on the web. To get that right, each field should get updated with the same response of a request.

              So I had a look closer into the ajax helper and the prototype framework and came up with a little hack that suffice my needs and might be also helpful for others.

              In the ajax helper (cake/libs/helpers/ajax.php) we first have to look into what happens when the options[update] parameter is set to an array with the different fields we want to update. That leads us to the ‘remoteFunction’ where following happens in that case:

              $func = "new Ajax.Updater(document.createElement('div'),";

              I have no clue what the creation of the div is really good for, but anyway we have to replace it with a JavaScript array holding the id’s of our fields:

              $update = '[';
              
              foreach($options['update'] as $option) {
                $update .= "'" . $option . "',";
              }            
              
              $update .= ']';                
              
              $func = "new Ajax.Updater({$update},";

              Now we must have a look into the prototype framework (app/webroot/js/prototype.js) and make sure the function Ajax.Updater can handle that array. The important function there is called updateContent:

              Ajax.Updater = Class.create();
              
              Object.extend(Object.extend(Ajax.Updater.prototype, Ajax.Request.prototype), {
              
                [...]
              
                updateContent: function() {
              
                  [...]
              
                  if (receiver = $(receiver)) {
                    if (this.options.insertion)
                      new this.options.insertion(receiver, response);
                    else
                      receiver.update(response);
                  }
              
                  [...]
                }
              });

              Because the receiver is now our array, we must step through it and send a response to each of it:

              Ajax.Updater = Class.create();
              
              Object.extend(Object.extend(Ajax.Updater.prototype, Ajax.Request.prototype), {
              
                [...]
              
                updateContent: function() {
              
                  [...]
              
                  if (receiver.constructor.toString().indexOf("Array") != -1) {
                    for(var i = 0; i < receiver.length; i++) {
                      if(r = $(receiver[i])) {
                    if (this.options.insertion)
                      new this.options.insertion(r, response);
                    else
                      r.update(response);
                  }
                    }
                  } else {
                    if (receiver = $(receiver)) {
                      if (this.options.insertion)
                        new this.options.insertion(receiver, response);
                      else
                        receiver.update(response);
                    }
                  }
              
                  [...]
                }
              });

              After checking if the receiver is actually an array, we step through it and send the response to every our fields.

              Finished!

              You can now use it like:

              <?php echo $ajax->remoteTimer(array('url' => 'controller/action', 'update' => array('field1', 'field2', 'field3'), 'frequency' => '5')); ?>
              Next Page »