Archives

Tag Archive for: ‘validation’

Kohana Tutorial: Part 2

Posted in: kohana, php|Tags: , , , , , |33 Comments

Here is the 2nd part of 3 part series of Kohana tutorial. First part of this tutorial can be found here as Kohana Tutorial: For the beginners. Same as before it is going to be 10+/- steps.

This part is going to cover
  • Template Controller in Kohana
  • Kohana ORM (relation & validation)

Why Template Controller?

Its tedious and repetitive task to create and manage all the view files with header, footer, menu… etc all the time. So it could be better, if we had a common template to handle this kind of stuffs. Kohana have Template Controller to rescue you.

Lets create a template

We want that, our website will have common pattern with header, menu, css etc. We need to create a simple template file like as below.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
	"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>Kohana Blog</title>
	<!-- this is how, you you can add a css file -->
	<?php echo HTML::style("public/css/template.css"); ?>
	<!-- this is how, you you can add a javascript file -->
	<?php echo HTML::script("public/js/jquery-1.6.4.js"); ?>
</head>

<body>
<div id="wrapper">
	<!-- Header for the site -->
	<div id="header"><h1>Kohana Blog</h1></div>
	
	<!-- Menu for the site -->
	<div id="navlist">
		<ul>
			<li><?php echo HTML::anchor("", "Home"); ?></li>
			<li><?php echo HTML::anchor("article", "Articles"); ?></li>
			<li><?php echo HTML::anchor("article/edit", "New Article"); ?></li>
		</ul>
	</div>
	
	<!-- here we load all content -->
	<div id="content">
		<?php echo $content; ?>
	</div>
	
	<!-- no footer added -->
</div>
</body>
</html>

Working with template controller

Now we need to say our controller that, from now on you are going to handle the template yourself. To do this we need to change our article controller. We can do it in following way.

  1. Extend Controller_Article from Controller_Template instead of Controller ;)
  2. Set the template for your controller as $template = “template”, since our template file is template.php in view folder.
  3. For all actions populate the $template as highlighted below at line 12. Do it for all other methods where required.
// extends the Controller_Template
class Controller_Article extends Controller_Template {

	public $template = 'template';
	...
	public function action_index() {
		$articles = ORM::factory('article')->find_all(); // loads all article object from table

		$view = new View('article/index'); // load 'article/index.php' view file
		$view->set("articles", $articles); // set "articles" object to view

		$this->template->set('content', $view); // renders a view as a response
	}
	...
}

It should be fun and easy to do this. Now hit the url: http://localhost/kohana-blog/index.php/article and see the magic. We can see a nice look of our Kohana Blog.

Read more »

Seam: Creating a custom converter

Posted in: java-ee|Tags: , , , , , |1 Comment

I was developing an application with Seam Framework. At a certain scenario for some reason I was needed to use h:inputText to bind a bean. Later on I found that it was raising an validation error message saying, Conversion Error setting value ‘xxx’ for ‘null Converter’.

<h:inputText value="#{lcInfo.itemIndentMastBean}" id="indentBean" required="true"/>

The reason for validatoin error is, an h:inputText can not bind to an object. That is the reason why it raises the validation error saying that, it can not convert a value using “null Converter”.

To solve this all you need is a custom Converter, which will convert the value from input text to a bean object. There are some tutorial regarding how to do it in JSF, but what about creating a custom converter using seam. Here is how u can do it.

  • Implement the Converter‘ interface and add the annotations as shown below.
package com.grandcorp.service.converter;

import java.io.Serializable;
import java.util.List;

import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;

import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.faces.Converter;
import org.jboss.seam.annotations.intercept.BypassInterceptors;

import com.grandcorp.entity.ItemIndentMast;
import com.grandcorp.service.ItemIndentMastServiceLocal;

@Name(value = "itemIndentMastConverter")
@Converter
@BypassInterceptors
public class ItemIndentMastConverter implements javax.faces.convert.Converter, Serializable {

	private static final long serialVersionUID = 1L;

	private ItemIndentMastServiceLocal itemIndentMastService;

	public ItemIndentMastServiceLocal getItemIndentMastService() {
		return itemIndentMastService;
	}

	public void setItemIndentMastService(ItemIndentMastServiceLocal itemIndentMastService) {
		this.itemIndentMastService = itemIndentMastService;
	}

	@Override
	public ItemIndentMast getAsObject(FacesContext facesContext, UIComponent uiComponent, String indentNumber) {
		List<itemindentmast> filterIndent = itemIndentMastService.filterIndent(indentNumber);
		if (filterIndent != null && filterIndent.size() == 1) {
			return filterIndent.get(0);
		}
		return null;
	}

	@Override
	public String getAsString(FacesContext facesContext, UIComponent uiComponent, Object indent) {
		if (indent != null) {
			return indent.toString();
		}
		return null;
	}

}
  • Now use the converter using f:converter in your h:inputText component as shown below.
<h:inputText value="#{lcInfo.itemIndentMastBean}" id="indentBean" required="true">
	<f:converter converterId="itemIndentMastConverter"/>
</h:inputText>

Additionally you may want to inject any dependency. You can do so via components.xml like as below I did for private ItemIndentMastServiceLocal itemIndentMastService;.

<component name="itemIndentMastConverter">
	<property name="itemIndentMastService">#{itemIndentMastService}</property>
</component>

So, this is it. Please make a comment if you find it difficult to implement.