SOURCE CODE: Uize.Parse.JavaProperties.Property

VIEW REFERENCE

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Parse.JavaProperties.Property Object
|   /    / /    |
|  /    / /  /| |    ONLINE : http://uize.com
| /____/ /__/_| | COPYRIGHT : (c)2014 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://uize.com/license.html
*/

/* Module Meta Data
  type: Object
  importance: 1
  codeCompleteness: 1
  docCompleteness: 2
*/

/*?
  Introduction
    The =Uize.Parse.JavaProperties.Property= module provides methods for parsing and serializing properties in [[http://en.wikipedia.org/wiki/.properties][Java properties]] files.

    *DEVELOPERS:* `Chris van Rensburg`
*/

Uize.module ({
  name:'Uize.Parse.JavaProperties.Property',
  required:[
    'Uize.Str.Whitespace',
    'Uize.Parse.JavaProperties.PropertyName',
    'Uize.Parse.JavaProperties.PropertyValue'
  ],
  builder:function () {
    'use strict';

    var
      /*** Variables for Performance Optimization ***/
        _Uize_Parse_JavaProperties_PropertyName = Uize.Parse.JavaProperties.PropertyName,
        _Uize_Parse_JavaProperties_PropertyValue = Uize.Parse.JavaProperties.PropertyValue,
        _indexOfNonWhitespace = Uize.Str.Whitespace.indexOfNonWhitespace,

      /*** General Variables ***/
        _separatorCharsLookup = _charsLookup ('=:')
    ;

    /*** Utility Functions ***/
      function _charsLookup (_charsStr) {
        return Uize.lookup (_charsStr.split (''));
      }

    return Uize.mergeInto (
      function (_source,_index) {
        var m = this;
        m.name = new _Uize_Parse_JavaProperties_PropertyName;
        m.value = new _Uize_Parse_JavaProperties_PropertyValue;
        this.parse (_source,_index);
      },
      {
        prototype:{
          source:'',
          index:0,
          length:0,
          isValid:false,

          parse:function (_source,_index) {
            function _eatWhitespace () {
              _index = (_indexOfNonWhitespace (_source,_index) + 1 || _sourceLength + 1) - 1;
            }
            var
              m = this,
              _sourceLength = (m.source = _source = _source || '').length
            ;
            m.index = _index || (_index = 0);
            m.name.parse (_source,_index);
            if (m.name.isValid) {
              _index += m.name.length;
              _eatWhitespace ();
              if (_separatorCharsLookup [_source.charAt (_index)]) {
                _index++;
                _eatWhitespace ();
              }
              m.value.parse (_source,_index);
              _index += m.value.length;
            }
            m.isValid = !!(m.length = _index - m.index);
          },

          serialize:function () {
            return this.isValid ? this.name.serialize () + ' = ' + this.value.serialize () : '';
          }
        }
      }
    );
  }
});