objectize v1.0.8

Introduction

Objectize is an easy-to-use and intelligent object mapping library for Node. Objectize can automatically maps HTTP(s) request data including query, parameters and body to an object.

• Objectize interface aims to require very minimal code to achieve the most common cases, basic installation and configuration less to only two steps
• Integrate perfectly with Express.js framework
• Organize HTTP request data (Cookie, IP Address, Params)

Installation

npm install objectize

Request library (without Express Framework)

var objectize = require('objectize')();

With Express Framework

var objectize = require('objectize')(app);

Features

1. Simpler Code, a easy-to-use data mapping API(s)
2. Automatically handles GET query, parameters, POST body/multipart data
3. Easy to integrate with Web Frameworks
4. Easy to extend and reuse
5. Model (Data Mapping) structure is flexible
6. Filtering unnecessary request data by model-mapper class

Sample Code

File: sample.js

var TYPE = require('objectize')().TYPES;
var model = function model() {
    this.required = {
        name					: TYPE.STRING,
        uid						: TYPE.SHA1
    }
    this.reference = {
    	uid						: 'name'
    }
};
module.exports = model;

File: test.js (Integrated with Express.JS Framework)

objectize.use('/:name', function(req, res, args, end){
	res.send(objectize.map(args, sample));
	end();
});

Example: http://127.0.0.1:5000/john

{
    "name": "John",
    "uid": "06c884c70d3d783563781f20fe9849ef916480d9"
}

As mentioned, Objectize can automatically filter unnecessary request data. http://127.0.0.1:5000/john?lastname=Eaton request will return the same result because the model doesn't have lastname field.

Model

Sections

Types

Advanced

Defaults and Privilege

With Objectize, you can assign a value to defaults / privilege section by a function.

this.defaults = {
	currentDateTime: function() {
		return new Date();
	}
}

Required and Optional (Reference)

Using reference system is simple. For an example, if you want to clone a value in different name field, you can do the following

this.required = {
	name: TYPE.STRING,
	copyname: TYPE.CLONE,
}
this.reference = {
	copyname: 'name'
}

The sole thing you require to do is assign 'copyname' with TYPE.CLONE type and determine the reference key to field 'name' in the reference section.

{
    "name": "John",
    "copyname": "John"
}

Same concept as well applied to SHA1, MD5, DATE Model Types.

Required and Optional (Function)

As same as defaults / privilege function but with more features.

this.required = {
	firstname: TYPE.STRING,
	lastname: TYPE.STRING,
	reg_date: TYPE.FUNCTION
}
this.functions = {
	reg_date: function() {
		return new Date().getTime();
	}
}

The output data will look like this.

{
    "firstname": "John",
    "lastname": "Raymond",
    "reg_date": 2002349203
}

For more advanced usage, you can do the following

this.required = {
	firstname: TYPE.STRING,
	lastname: TYPE.STRING,
	reg_date: TYPE.FUNCTION,
	fullname: TYPE.FUNCTION
}
this.functions = {
	reg_date: function() {
		return new Date().getTime();
	},
	fullname:['firstname', 'lastname', function(firstname, lastname) {
		return firstname + ' ' + lastname;
	}]
}

The Mapper will automatically grab the firstname, and lastname to the function. keys, function(args)

{
    "firstname": "John",
    "lastname": "Raymond",
    "reg_date": 2002349203,
    "fullname": "John Raymond"
}

Why is Objectize so useful?

Objectize can immediately turns a input data to a valuable and usable data that could be stored in database. Below are two solutions of user register API that store user data to RethinkDB NoSQL.

Solution 1: Without Objectize

app.post('/signup', function(req, res) {
	async.parallel([
		function(callback) {
			var body = '';
			req.on('data', function(chunk) {
				body += chunk.toString();
			});
			req.on('end', function() {
				callback(null, querystring.parse(body) || {});
			});
		}
	], 
	function(err, results) {
		var params = results[0];
		var data = {};
		var emailRegex = /^(([^<>()[\]\\.,;:\s@\"]+(\.[^<>()[\]\\.,;:\s@\"]+)*)|(\".+\"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
		var sendError = function() {
			res.send(JSON.stringify({success:false}));
		}
		var sha1 = function(str) {
			var shasum = crypto.createHash('sha1');
			shasum.update(str);
			return shasum.digest('hex');
		}
		if (params.email && emailRegex.test(params.email)) {
			data.email = params.email;
			data.userid = sha1(params.email);
		} else {
			sendError();
		}
		if (params.password && params.password.length > 0) {
			data.password = params.password;
		} else {
			sendError();
		}
		data.reg_date = new Date();
		r.table('account').insert(data).run().then(function(result) {
			data.success = true;
			res.send(JSON.stringify(data));
		});
	});
	
});

Solution 2: With Objectize

signup.js (model)

var model = function model() {
    this.required = {
        email		: TYPE.EMAIL,
        userid		: TYPE.SHA1,
        password	: TYPE.STRING,
        reg_date	: TYPE.NOW
    }
    this.reference = {
    	userid		: 'email'
    }
};
module.exports = model;

app.js

objectize.post('/signup', function(req, res, args, end) {
	var data = objectize.map(args, signup) || this.drop({success:false});
	this.do(function() {
		r.table('account').insert(data).run().then(function(result) {
			data.success = true;
			res.send(data);
		});	
	});
	end();
});

Contributing

You want to contribute? Great! That would be awesome! Pull requests are always welcome.