Restful webservice using CFX and Spring

1. Create a new Maven Web project using Netbeans IDE. (Version used for this post is 7.3 beta3)

2. Run through the wizard to create the Maven Web Application. here i have given the name "CFXSpring" as the project name.

3. In the next screen of the wizard select the server of your choice.  Here i have selected Glassfish server which comes bundled with Netbeans.

4. Then click on finish, your project is ready to use. Here you can notice the following folder structure is created by Maven for you.

5. Now its time to add Spring MVC Framework to our application. So right click on the project node in project window and go to properties menu item. IDE will pop up a properties window for you. In that window go to "Frameworks" categories.  In the right panel of the window you will get a empty text area with an "Add" button to its right. Just Click on the Add button.Another framework window will pop up with the list of frameworks works available to choose from.  Select Spring Web MVC from that window.  See the screen shot below for clarity.

6. Now select the Spring Framework version you like to use with this application.  Here i have selected 2.5.6 to use with my application.  see the figure below.

7. Once the above step is done.  Spring frame work will be added to the project by the IDE, by including the needed dependencies to the POM.XML file. By the way adding the dependencies to the project dependencies folder. see the figure below.

8. Now you can see there is a change in the project folder structure also.  A new folder "WEB-INF" is added to the project. That folder will also contain "applicationContext.xml" which is nothing but the Spring Configuration file where we will be wiring our beans and bean dependencies through property or constrructer injection. also you can see "web.xml" which is nothing but the web applications deployment descriptor.

9. In "web.xml" you can see already "org.springframework.web.servlet.DispatcherServlet" is configured for you by the IDE. so no need for us to do any extra configuration with respect to spring.

10. Now its time to add CFX dependencies to POM.XML.  This we will do manually with out using any of the IDE's wizards.

11. Open the "pom.xml" file which will be located in the projectfiles folder of the project.

12. Go to "dependencies" tag. and add the following dependency to it.

Camel-Jetty Step by Step using Netbeans IDE

Camel-Jetty Step by Step using Netbeans IDE

1. Create a Maven Java project using Netbeans IDE (Version used - 7.3 beta2)

1. Go to New project wizard and Create a new maven java project
2. 
3. Here for our sample the project is named as “MyHTTP”

4. Click on finish
5. now the IDE will create a Java Maven project for you with the recommended folder structure like below.

6. Just check the POM.XML found inside the “ProjectFiles” folder. which will have the dependencies and plugin’s added automatically by the IDE. POM created for “MyHTTP” is shown below.

7. Now its time to add Camel dependencies to our POM.XML file. add the following dependencies to your pom.xml file inside the dependencies tag.

        

       

       

8. Once the dependencies are added just clean and build your project. so that maven will download the required jar files listed in the dependencies tag to your project from the central repository. and also will pack the required JAR files to your “\MyHTTP\target\” path with name “MyHTTP-1.0-SNAPSHOT.jar”.
9. Now in your project you can see a main class created with the name “App.java”.
10. its time to edit the java class App.java and add the following code to it.

package com.mm.myhttp;

import java.util.logging.Level;

import java.util.logging.Logger;

import javax.servlet.http.HttpServletRequest;

import org.apache.camel.Exchange;

import org.apache.camel.Processor;

import org.apache.camel.builder.RouteBuilder;

import org.apache.camel.impl.DefaultCamelContext;

/**

 *

 * @author Muthu

 */

public class App {

    public static void main(String[] args) {

        DefaultCamelContext camelContext = new DefaultCamelContext();

        try {

            camelContext.addRoutes(new RouteBuilder() {

                @Override

                public void configure() throws Exception {

                    from("jetty:http://0.0.0.0/myapp/myservice/?sessionSupport=true")

                            .process(new Processor() {

                        @Override

                        public void process(Exchange exchng) throws Exception {

                            System.out.println("Inside process exchange");

                            String body = exchng.getIn().getBody(String.class);

                            // this is the way to access HttpServletRequest

                            HttpServletRequest req =

                                    exchng.getIn().getBody(HttpServletRequest.class);

                            // send a html response back to client

                            exchng

                                    .getOut()

                                    .setBody(""

                                    + "Simple Demo for Camel-Jetty component"

                                    + "

");

                        }

                    });

                }

            });

            camelContext.start();

        } catch (Exception ex) {

            Logger.getLogger(App.class.getName()).log(Level.SEVERE, null, ex);

        }

    }

}

11. the important part of the code is “from("jetty:http://0.0.0.0/myapp/myservice/?sessionSupport=true")” from route which starts jetty server and listens to the http url mentioned in the from route.
12. then the route flows to the process where a html response is set to the body and returned to the client.
13. To test this application, just run the Java Maven project with App.java as the main class.

14. In the Output window you can see the http service running at port 80. and our component uses Jetty-7.5.4 to run the service.

15. Now hit the url(http://localhost/myapp/myservice/) using your browser and you should be able to see the html response back from the service.

Convert a String to Lower Case in Java

Here this post will show you how to convert a string to lower case in Java.

String actualValue = "JAVA WAVE";  
  
String lowerCase = actualValue.toLowerCase();

Generate a unique identifier with java.util.UUID

Java SE 5 has introduced the java.util.UUID class to easily generate Universally Unique Identifier (UUID)

import java.util.UUID;

/**
 * This class is used to generate UUID and return it as a String object
 * 
 * @author dhanago
 * 
 */
public class GenerateUUID
{
    /**
     * method to return UUID as a String object
     * 
     * @return
     */
    public static String getUUID()
    {
 return UUID.randomUUID().toString();
    }
}

Java utility to read from resource bundle or properties file

    /**
     * dataSource.properties is loaded to a resource bundle.
     */
    public static ResourceBundle resourceBundle = ResourceBundle.getBundle(
            "sample.prop.health");

    /**
     * This method will return the value of the property from the resource
     * bundle.
     *
     * @param key
     *            property key
     * @return property value
     */
    public static String getProperty(String key)
    {
        String value = null;
        try
        {
            value = resourceBundle.getString(key);
        }
        catch (MissingResourceException missingResourceException)
        {
            Logger.getLogger(Utility.class.getName()).
                    log(Level.SEVERE,
                    "Resource Bundle not found",
                    missingResourceException);
        }
        return value;
    }

Java method to format the current date to yyyy-MM-dd using SimpleDateFormat.

    /**
     * This method will format the current date to yyyy-MM-dd.
     * @return
     *      current date as String.
     */
    public static String formatedCurrentDate()
    {
        String toDate = new Date().toString();
        SimpleDateFormat formatter = new SimpleDateFormat(
                "EEE MMM yyyy hh:mm:ss zzz");
        Date date = formatter.parse(toDate,
                new ParsePosition(0));

        toDate = new SimpleDateFormat("yyyy-MM-dd").format(date);
        return toDate;
    }

Java method to return a File object from the file path specified

    /**
     * This method will return a file from the path specified.
     *
     * @param path
     *            path of the file name.
     * @param fileName
     *            Name of the file.
     * @return File object
     */
    public static File readFileFromPath(String path, String fileName)
    {
        String fileNameWithPath = null;
        if (path.endsWith("/"))
        {
            fileNameWithPath = path + fileName;
        }
        else
        {
            fileNameWithPath = path + "/" + fileName;
        }
        File file = new File(fileNameWithPath);

        return file;
    }

Reading file as String in Java

    /** This method will read a file as String
     * @param filePath
     * @return file as String
     * @throws java.io.IOException
     */
    public static String readFileAsString(String filePath)
            throws java.io.IOException
    {
        StringBuffer fileData = new StringBuffer(1000);
        BufferedReader reader = new BufferedReader(new FileReader(filePath));
        char[] buf = new char[1024];
        int numRead = 0;
        while ((numRead = reader.read(buf)) != -1)
        {
            String readData = String.valueOf(buf,
                    0,
                    numRead);
            fileData.append(readData);
            buf = new char[1024];
        }
        reader.close();
        return fileData.toString();
    }

Java method to replace every occurences of a string within another string

    /**
     * This method will replace every occurences of a string within another
     * string.
     *
     * @param target
     *          is the original string
     * @param from
     *          is the string to be replaced
     * @param to
     *          is the string which will used to replace
     * @return
     *          changed new string
     */
    public static String replace(String target, String from, String to)
    {
        int start = target.indexOf(from);
        if (start == -1)
        {
            return target;
        }
        int fromLength = from.length();
        char[] targetChars = target.toCharArray();
        StringBuffer buffer = new StringBuffer();
        int copyFrom = 0;
        while (start != -1)
        {
            buffer.append(targetChars,
                    copyFrom,
                    start - copyFrom);
            buffer.append(to);
            copyFrom = start + fromLength;
            start = target.indexOf(from,
                    copyFrom);
        }
        buffer.append(targetChars,
                copyFrom,
                targetChars.length - copyFrom);
        return buffer.toString();
    }

Converting Java String to double

The following code will convert Java String into double data type.

package com.javaWave.blogSpot;

public class String2double {

 /**
  * @param args
  */
 public static void main(String[] args) {
  // String myString = "javaWave"; // do this if you want an exception

  String myString = "100.00";

  try {
   double convertedValue = 
    Double.valueOf(myString.trim()).doubleValue();
   System.out.println("convertedValue = " + convertedValue);
  } catch (NumberFormatException nfe) {
   System.out.println("NumberFormatException: " 
     + nfe.getMessage());
  }

 }

}

Hibernate support in Netbeans IDE 6.1

http://www.netbeans.tv/screencasts/Hibernate-Support-in-the-NetBeans-IDE-370/

Core Java Notes- Part I

Designing a class:
Think about objects created from the class.
· Things the object knows about itself-> instance variable
· Things the object does-> methods.
Note: think of instance as another way of saying object.
Difference between a class and a object:
Note: a class is not an object
->class is used to construct an object
A class is an blueprint for an object
-> tells the virtual machine how to make an object of the particular type.
Example: An object is like one entry in your address book.
The two uses of main:
1. To test your real class.
2. To launch/ start your java application.
The Heap
Each time an object is created in java, it goes into an area of memory known as the Heap. All objects created live on the heap.
Note: The java heap is actually called as Garbage collectable heap.
Java manages the memory for you. When the JVM can see that an object can never be used again, that object becomes eligible for garbage collection. And if you are running low on memory, the garbage collector will run, throw out the unreachable objects, and free up the space, so that the space can be reused.


Marking a method as public and static:
Marking a method as public and static makes it behave much like a ‘global’.
Note: Any code in any class of your application can access a public static method.
If you mark a variable as public, static and final, you have essentially made a globally available constant.
Variables
2 flavours of variables,
· Primitive
· Reference
Primitive: Hold fundamental values including integers, Booleans and floating point numbers.
Object references: hold, well, references to objects.
Two declare a variable you must follow two rules:
1. variables must have a type.
2. variables must have a name.
Example:
int count
here,
int ==> Type, and
count ==> Name.
Note: A variable is just a container that holds something.


You can assign a value to a variable in one of several ways including:
> Type a literal value after the equal sign, eg., x=12, isgod=true; etc.,
> assign the value of one variable to another (x=y).
> use an expression combining the two. Eg.(x=y+43).
Note: You need a name and a type for your variables
int size = 32
here ,
int ==> Type,
size ==> Name, and
32 ==> Literal

Safe naming rules for a class method or variable:
· it must start with a letter, underscore(_), or dollar sign($).you can’t start a name with a number.
· After the first character you can use the number as well.
· It can be anything you like, subject to those two rules, just so long as it isn’t one of java’s reserved words.

Reserved words Table:
Non-Primitive Variables/Objects:
There is actually no such thing as an object variables
There is only an object reference variable.
An object reference variable holds bits that representation way to access an object. And the JVM knows how to use the reference to get to the object.
Note: Objects live in one place-the garbage collectible heap!
Arrays: Arrays are always objects, whether they are declared to hold primitives or object references.
Note: once you have declared an array, you can’t put anything in it except things that are of the declared array type.
Bullet Points:
Variables come in two flavours,
1. Primitive
2. Reference
Variables must always be declared with a name and a type.
A primitive variable value is the bits representing a way to get to an object on the heap.
A reference variable is like a remote control using the dot operator (.) on a reference variable is like pressing a button on the remote control to access a method or instance variable.
A reference variable has a value of null when it is not referencing any object.
An array is always an object, even if the array is declared to hold primitives. There is no such thing as a primitive array, only an array that holds primitives
Note: Java is pass-by-value (i.e) pass-by-copy.
Bullet Points:
· Classes define what an object knows and what an object does.
· Things an object knows are its instance variables(state).
· Things an object does are its methods(behaviour).
· Methods can use instance variables so that objects of the same type can behave differently.
· A method can have parameters, which means you can pass one or more values into the method.
· The number and type of values you pass in must match the order and type of the parameters declared by the method.
· Values passed in and out of methods can be implicitly promoted to a larger type or explicitly cast to a smaller type.
· The value you pass as an argument to a method can be a literal value (2, ‘c’,etc) or a variable of the declared parameter type (for example, x where x is an int variable).
· A method must declare a return type. A void return type means the method doesn’t return type.
Encapsulation ==> Hide the data:
Rule of thumb: Mark your instance variables private and provide public getters and setters for access control.
The difference between instance and local variable.
instance variable are declared inside a class but not within a method.
local variables are declared within a method.
local variables must be initialized before use.
Note: Local variables do not get a default value! The compiler complains if you try to use a local variable before the variable is initialized.
Note: Method parameters are virtually the same as local variables. But method parameters will never get a compiler error telling you that a parameter variable might not have been initialized.

Quartz Job Scheduler -- Part II (Example, Simple Trigger)

In this example we will see how to implement a Simple scheduler with the help of Quartz Framework.

Our application will just print Hello World on console after specified time.

For implementing the scheduler using quartz we need two classes.
1. which will implement org.quartz.Job interface, and the other
2. the scheduler class which will start the scheduler.

Now we will see the code which will implement Job interface:

package com.MyQuartz.simple;

import java.util.Date;
import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

/**
*
* @author dhanago
*/
public class HelloJob implements Job {

public void execute(JobExecutionContext jobExecutionContext)
throws JobExecutionException {
System.out.println("Hello World -- Executed on : " + new Date());
}
}

Here,
execute() --> is an overridden method. When ever Job interface is implemented its execute() of method should be overridden. Note that any component you want to schedule should implement Job interface.

JobExecutionContext --> is passed as an parameter to the execute() method. this provides the job instance which provides the job instance with information about its run-time environment. From this we will get the job detail information and also some important information regarding its triggers etc.,

Now we will see the code which will start the scheduler:

package com.MyQuartz.simple;

import java.util.Date;
import java.util.logging.Level;
import java.util.logging.Logger;
import org.quartz.JobDetail;
import org.quartz.Scheduler;
import org.quartz.SchedulerException;
import org.quartz.SimpleTrigger;
import org.quartz.impl.StdSchedulerFactory;

/**
*
* @author dhanago
*/
public class StartScheduler {

public void startScheduler()
throws SchedulerException {
Scheduler scheduler = new StdSchedulerFactory().getScheduler();
scheduler.start();
JobDetail jobDetail = new JobDetail(
"MyJob", scheduler.DEFAULT_GROUP, HelloJob.class);
SimpleTrigger simpleTrigger = new SimpleTrigger(
"MyTrigger", scheduler.DEFAULT_GROUP, new Date(),
null, SimpleTrigger.REPEAT_INDEFINITELY, 60L * 1000L);
scheduler.scheduleJob(jobDetail, simpleTrigger);
}

public static void main(String args[]) {

StartScheduler startScheduler = new StartScheduler();
try {
startScheduler.startScheduler();
}
catch (SchedulerException ex) {
Logger.getLogger(StartScheduler.class.getName()).
log(Level.SEVERE, null, ex);
}
}
}

Here,

StdSchedulerFactory(): A Class StdSchedulerFactory is a class and it is implementation of SchedulerFactory interface. Here it just using for create an instance of SchedulerFactory instance.

Scheduler: Scheduler interface is the main interface (API) to this functionality. It provides some simple operations like scheduling jobs, unscheduling jobs, starting/stopping/pausing the scheduler.

start(): This method is used to starts the Scheduler's threads that fire Triggers. At the first time when we create the Scheduler it is in "stand-by" mode, and will not fire triggers. The scheduler can also be send back into stand-by mode by invoking the standby() method.

JobDetail(String name, String group, Class jobclass): The JobDetail object is created at the time the Job is added to scheduler. It contains various property settings like job name, group name and job class name. It can be used to store state information for a given instance of job class.

SimpleTrigger(String name, String group, Date startTime, Date endTime, int repeatCount, long repeatInterval): Trigger objects are used to firing the execution of jobs. When you want to schedule the job, instantiate the trigger and set the properties to provide the scheduling.

DEFAULT_GROUP: It is a constant, specified that Job and Trigger instances are belongs to which group..

REPEAT_INDEFINITELY: It is a constant used to indicate the 'repeat count' of the trigger is indefinite.

scheduleJob(JobDetail jobDetail, SimpleTrigger simpleTrigger): This method is used to add the JobDetail to the Scheduler, and associate the Trigger with it.

OutPut:


init:
deps-jar:
compile-single:
run-single:
log4j:WARN No appenders could be found for logger (org.quartz.simpl.SimpleThreadPool).
log4j:WARN Please initialize the log4j system properly.
Hello World -- Executed on : Mon Apr 14 22:52:25 IST 2008
Hello World -- Executed on : Mon Apr 14 22:53:25 IST 2008
Hello World -- Executed on : Mon Apr 14 22:54:25 IST 2008
Hello World -- Executed on : Mon Apr 14 22:55:25 IST 2008

Quartz Job Scheduler -- Part 1 (Setting up development project in Netbeans 6.1 beta)

Setting up development project in Netbeans 6.1 beta

Step 1 :Run Netbeans IDE and create a New Java project opening the new project creation wizard like below.
Step 2: Click on the Next button and enter the project name. Here i am giving the name as "MyQuartz". Click on finish. (see the below figure)
Step 3: Download Quartz from the location --> http://www.opensymphony.com/quartz/download.action . Once downloaded extract the archive to a location.
Step 4: The below table explains the files inside the extracted archive.

Files/Directory	Purpose
quartz-all-.jar	Quartz library includes the core Quartz components and all optional packages. If you are using this library then no other quartz-*.jars need to include.
quartz-.jar	core Quartz library.
quartz-jboss-.jar	optional JBoss Quartz extensions such as the Quartz startup MBean, QuartzService.
quartz-oracle-.jar	optional Oracle specific Quartz extensions such as the OracleDelegate
quartz-weblogic-.jar	optional WebLogic specific Quartz extensions such as the WebLogicDelegate
build.xml	an "ANT" build file, for building Quartz.
docs	root directory of all documentation
docs/wikidocs	the main documentation for Quartz. Start with the "index.html"
docs/dbTables	sql scripts for creating Quartz database tables in a variety of different databases.
src/java/org/quartz	the main package of the Quartz project, containing the 'public' (client-side) API for the scheduler
src/java/org/quartz/core	a package containing the 'private' (server-side) components of Quartz.
src/java/org/quartz/simpl	this package contains simple implementations of Quartz support modules (JobStores, ThreadPools, Loggers, etc.) that have no dependencies on external (third-party) products.
src/java/org/quartz/impl	this package contains implementations of Quartz support modules (JobStores, ThreadPools, Loggers, etc.) that may have dependencies on external (third-party) products - but may be more robust.
src/java/org/quartz/utils	this package contains some utility/helper components used through-out the main Quartz components.
src/examples/org/quartz	this directory contains some examples usage of Quartz.
webapp	this directory contains a simple web-app for managing Quartz schedulers.
lib	this directory contains all third-party libraries that are needed to use all of the features of Quartz.

Step 5: Open Add JAR/Folder wizard in netbeans like shown below.

Step 6: Add "quartz-all-1.6.0.jar" and all other jars found inside "lib" folder. See the below figure to see the added jars to the project.

Step 7: Now the Development Environment is ready.

Collection of Jars in One place

From the below URL we can find the collection of Java related jars in one place.

http://www.java2s.com/Code/Jar/CatalogJar.htm

Highlights of NetBeans 6.1

Highlights of NetBeans 6.1 include:

* JavaScript support such as semantic highlighting, code completion, type analysis, quick fixes, semantic checks and refactoring;

* Performance enhancements including faster startup and code completion;

* Spring framework support with features such as configuration file support, code completion and hyperlinks to speed navigation;

* New MySQL support in the Database Explorer to make it easier to create, launch and view MySQL databases;

* Significant enhancements to the Ruby/JRuby support, including a new Ruby platform manager, support for the latest version of Rails and new hints and quick fixes in the editor;

* Beta support for the ClearCase version control system - made available as a plugin from the Update Center.

download from --> http://dlc.sun.com.edgesuite.net/netbeans/6.1/beta/

Spring - Part I

Here is the simple example to start up with spring,

To write a simple spring application we need one interface, one implementation of that interface and a test client to test the implementation. Apart form that we also need a configuration XML file.

One interface --> Hello.java
One implementation --> HelloImpl.java
One Test Client --> HelloClient.java
One Spring XML File --> Hello.xml (Should be in the classpath).

Now let us see the interface Hello.java.

package com.javawave.spring.cli;

/**
 * @author dhanago
 */
public interface Hello
{
   /**
    * This method will return the salutation for the name passed as input
    * param to it.
    * 
    * @param name
    * @return
    */
   public String sayHello( String name );
}

The above interface has only one method to say hello. This method has to be implemented in the implementation class "HelloImpl.java"

package com.javawave.spring.cli;

/**
 * @author dhanago
 */
public class HelloImpl implements Hello
{

   private String greet;

   /**
    * zero-arg constructor
    */
   public HelloImpl()
   {
      
   }

   /**
    * @param greet
    */
   public HelloImpl( String greet )
   {
      this.greet = greet;
   }

   /*
    * (non-Javadoc)
    * 
    * @see com.javawave.spring.cli.Hello#sayHello(java.lang.String)
    */
   public String sayHello( String name )
   {

      return this.greet + name;
   }

   /**
    * @param greet the greet to set
    */
   public void setGreet( String greet )
   {
      this.greet = greet;
   }

}

The Impl class has a property called greet. This also has a setter method "setGreet" to set the value for this property.

Now let us see the spring xml. This XML file will be used for creating the objects in spring framework. This XML is also called wiring xml. Through this XML we will set the greet property of the HelloImpl class.

Hello.XML
~~~~~~~~~

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC
"-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd">
  <beans>
   <bean id="hello"
         class="com.javawave.spring.cli.HelloImpl">
     <property name="greet">
       <value>Good Morning!...</value>
     </property>
   </bean>
</beans>

Here in the XML you can see the tag called bean which will map to the bean what you are using in the application. It has an attribute called "id" and a attribute called "class". The "class" attribute maps to the HelloImpl.java in our case. The property tag inside the bean tag maps to the property inside the bean class. Here in our case it is the "greet" property. The value for the property is given in the value element inside the property element. This is the value passed to the bean's property "greet" . This is how spring does the dependency injection (DI). Here what you are doing is injecting dependency through setter method. This is also called Setter Injection.

Now we will see the client application "HelloClient.java" to test the "HelloImpl.java".

/**
 * 
 */
package com.javawave.spring.cli;

import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.xml.XmlBeanFactory;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;

/**
 * @author dhanago
 */
public class HelloClient
{

   /**
    * @param args
    */
   public static void main( String[] args )
   {
      try
      {
         System.out.println( "Inside main of HelloClient.." );
         Resource resource = new ClassPathResource(
               "com/javawave/spring/cli/Hello.xml" );
         BeanFactory factory = new XmlBeanFactory( resource );
         Hello hello = (Hello) factory.getBean( "hello" );
         String result = hello.sayHello( "Man" );
         System.out.println( result );
      }
      catch (Exception e)
      {
         System.out.println( "Exception/Error:" + e.toString() );
      }
   }
}

This client application uses ClassPathResource to load the resource. In our case Hello.xml and it creates the factory via XmlBeanFactory. factory class has getBean method which will return a object. Here we get Hello object. So from that we can call sayHello method as shown in the above code and get the result.

The Jars used for this application is:
spring.jar
commons-logging.jar

The Output is shown below:

Inside main of HelloClient..
Good Morning!...Man
Dec 3, 2007 1:59:01 PM org.springframework.beans.factory.xml.XmlBeanDefinitionReader loadBeanDefinitions
INFO: Loading XML bean definitions from class path resource [com/javawave/spring/cli/Hello.xml]

Comparing two Value Objects in Java

In Java comparing two value object is not straight forward. Here we will see how we can compare two value objects in Java.

For that first we will create a value object called "MyValueObject". This value object contains two properties. 1) firstName 2) lastName. Both the properties are of type string.

In the same class we also have a overridden method which does the comparison for us. This method "public boolean equals(Object obj)" takes the properties and compare them individually. if the properties values are all equal then it returns true or it will return false. By doing this our test class will just call the equals method on the object to make sure if the objects are equal or not.

Code is listed below.

/*
 */
package com.blogspot.javawave;

/**
 *
 * @author dhanago
 */
public class MyValueObject
{

    private String firstName;
    private String lastName;

    /**
     * This constructor is used to set the two properties values in the class.
     *
     * @param firstName
     * @param lastName
     */
    public MyValueObject(String firstName,
                          String lastName)
    {
        this.firstName = firstName;
        this.lastName = lastName;
    }

    @Override
    public boolean equals(Object obj)
    {
        boolean isEqual = false;
        if (this.getClass() == obj.getClass())
        {
            MyValueObject myValueObject = (MyValueObject) obj;
            if ((myValueObject.firstName).equals(this.firstName) &&
                    (myValueObject.lastName).equals(this.lastName))
            {
                isEqual = true;
            }
        }

        return isEqual;
    }
}

Test class is given below:

/*
 */
package com.blogspot.javawave;

/**
 *This class is used to test compare the value object.
 *
 * @author dhanago
 */
public class TestCompareValueObject
{

    /**
     * This is the main method used to test compare the value object.
     * @param arg
     */
    public static void main(String[] arg)
    {
        MyValueObject obj1 = new MyValueObject("Muthu", "Kumar");
        MyValueObject obj2 = new MyValueObject("Muthu", "Kumar");
       
        if (obj1.equals(obj2))
        {
            System.out.println("Both the objects are equal");
        }
        else
        {
            System.out.println("Both the objects are not equal");
        }
    }
}

This one of the way we can easily compare the value objects in Java

SOA principles

SOA principles

The following guiding principles define the ground rules for development, maintenance, and usage of the SOA^[8]

• Reuse, granularity, modularity, composability, componentization, and interoperability
• Compliance to standards (both common and industry-specific)
• Services identification and categorization, provisioning and delivery, and monitoring and tracking

The following specific architectural principles for design and service definition focus on specific themes that influence the intrinsic behaviour of a system and the style of its design:

• Service Encapsulation - A lot of existing web-services are consolidated to be used under the SOA Architecture. Many a times, such services have not been planned to be under SOA.
• Service Loose coupling - Services maintain a relationship that minimizes dependencies and only requires that they maintain an awareness of each other
• Service contract - Services adhere to a communications agreement, as defined collectively by one or more service description documents
• Service abstraction - Beyond what is described in the service contract, services hide logic from the outside world
• Service reusability - Logic is divided into services with the intention of promoting reuse
• Service composability - Collections of services can be coordinated and assembled to form composite services
• Service autonomy – Services have control over the logic they encapsulate
• Service optimization – All else equal, high-quality services are generally considered preferable to low-quality ones
• Service discoverability – Services are designed to be outwardly descriptive so that they can be found and assessed via available discovery mechanisms^[9]

In addition, the following factors should also be taken into account when defining a SOA implementation:

• SOA Reference Architecture covers the SOA Reference Architecture, which provides a worked design of an enterprise-wide SOA implementation with detailed architecture diagrams, component descriptions, detailed requirements, design patterns, opinions about standards, patterns on regulation compliance, standards templates etc.^[10]
• Life cycle management SOA Practitioners Guide Part 3: Introduction to Services Lifecycle introduces the Services Lifecycle and provides a detailed process for services management though the service lifecycle, from inception through to retirement or repurposing of the services. It also contains an appendix that includes organization and governance best practices, templates, comments on key SOA standards, and recommended links for more information.
• Efficient use of system resources
• Service maturity and performance
• EAI Enterprise Application Integration

What is WSDL?

WSDL stands for Web Services Description Language. A WSDL file is an XML document that describes a Web service. It specifies the location of the service and the operations (or methods) the service exposes. For more information about WSDL, refer to the WSDL specification, or read the WSDL tutorial