Sutra ........

Reading Experimental Result Code in Sun Diameter stack

softwaresutra — Thu, 15 Oct 2009 05:43:03 +0000

Here is a code snippet that shows how to read AVP’s that any of the response API’s does not directly expose.
In this case we see how to read Experimental Result Code AVP value.

UserProfileConnection upc = hss.createConnection(); ReadProfileKey rpk = new ReadProfileKey(); rpk.addDataReference(DataReference.IMS_USER_STATE); rpk.addServiceIndicator("default_sp"); UserIdentity uID = new UserIdentity("sip:bob@open-ims.test", UserIdentityType.PUBLIC_USER_ID); rpk.setUserIdentity(uID); rpk.validate(); UserProfileReadResponse response = upc.read(rpk, false); if (response == null) { throw new RuntimeException("response is null"); } ProfileData data = ((UDResponse) response).getProfileData();

if (data != null) { System.out.println(count++ + ":" + new String(data.toBytes())); } ExperimentalResult result = (ExperimentalResult)response.getAVP(297); System.out.println((result.getExperimentalResultCode()));

Reset mysql root password in ubuntu

softwaresutra — Wed, 07 Oct 2009 05:28:36 +0000

Here is what I did to reset the root user password for mysql 5.0 on my ubuntu desktop.

sudo dpkg-reconfigure mysql-server-5.0

This command will pop up aUI which enables you to set a new password.

Difference between PUT and POST in HTTP

hra078 — Thu, 13 Aug 2009 12:55:31 +0000

An area of confusion in REST over HTTP is the difference between PUT and POST.

PUT is used to create or replace a resource. URI in a PUT request identifies the entity enclosed with the request . POST is used to create a subordinate resource. The URI in a POST request identifies the resource that will handle the enclosed entity. Very often PUT is mapped to Update task of a CRUD applications and POST is mapped to Create task . There are some caveats though as pointed here.

PUT requires a complete replacement
PUT can be used to Create a resource (when the URI is set by the client)
POST supports only the creation of a child resource.
POST supports partial updates.

Diameter Online Charging(Ro) Javadocs available

softwaresutra — Tue, 28 Jul 2009 02:45:23 +0000

Javadocs for Sun Diameter Online charging API’s are now available here.

Code Syntax highlighter

softwaresutra — Mon, 20 Jul 2009 04:10:31 +0000

A nice set of scripts from http://code.google.com/p/syntaxhighlighter/

//Read User Profile information
//Create a ReadProfile key identifying data to be read.
ReadProfileKey rpk = new ReadProfileKey();
UserIdentity uID = new UserIdentity(“sip:bob@open-ims.test”, UserIdentityType.PUBLIC_USER_ID);
rpk.addDataReference(DataReference.REPOSITORY_DATA);
rpk.addServiceIndicator(“default_sp”);
rpk.setUserIdentity(uID);
//check if all the required information is present.
rpk.validate();
//get profile data
UserProfileReadResponse profileResponse = upc.read(rpk, false);
//now read the information.
ProfileData profileData = ((UDResponse) profileResponse).getProfileData();
JAXBContext context = JAXBContext.newInstance(“com.sun.diameter.application.sh.userdata”);
JAXBElement ob = (JAXBElement) context.createUnmarshaller().unmarshal(new ByteArrayInputStream(profileData.toBytes()));
//UPDATE userpfofile information using setter methods provided on JAXB objects and increment the sequence number….
TTransparentData transData = (TTransparentData) ((ob.getValue()).getRepositoryData()).get(0);
transData.setSequenceNumber(transData.getSequenceNumber() + 1);
//Prepare to update the HSS with modified user profile information
UpdateKey upk = new UpdateKey();
upk.addDataReference(DataReference.REPOSITORY_DATA);
upk.setUserIdentity(uID);
upk.setServiceIndicator(“default_sp”);
JAXBSource jxsource = new JAXBSource(context, ob);
//update the HSS
UserProfileUpdateResponse response = upc.update(upk, jxsource, false);

Updating user profile information in HSS using Sailfin diameter Sh API.

softwaresutra — Thu, 16 Jul 2009 03:06:16 +0000

In the below code snippet we see how to read the user repository data from HSS,modify the data and update the HSS. Sh API makes this operation a breeze. OpenIMS HSS is one of the HSS server being used to test SH API’s.
In simple steps :
1.Look up HSS server
2.Create ReadProfileKey with required information and validate it to ensure required information to construct a valid message is there.
3.convert the retrieved profile data into JAXB objects
4.Update the profile data using setter methods provided by JAXB
5.Create a UpdateKey
6.send out the modified information.

Use ViewImage option to look @ the code snippet…
.

Quick look @ Online Charging in Sailfin Communication server

softwaresutra — Wed, 15 Jul 2009 10:11:03 +0000

Wrapping up development on Online and Offline charging API in Sailfin communication server. Here is a sample that shows a charging client accessing Ericsson Charging Server.

PartOne: Initial Request in Session based online charging.
View image to look at the source.

PartTwo: Update and Terminate Request in Session based online charging.
The below code snippet shows how to update a charging session and terminate one. The code snippet has comments to help you understand the code.

.

Highlights of Diameter support in Sailfin
1.Easy to use API , interfaces provided for AVP’s defined in 3GPP specs and RFC’s
2.Easy to query additional AVP’s in a Grouped AVP.
3.Easy to add new AVP support using dictionary or annotations.
4.Ability to send messages in a synchronous or asynchronous manner(Listener support to receive asynchronous responses)
5.Interfaces defined to build messages as per 3GPP specifications.
6.Easy to build custom messages as shown in the code snippet.
7.Diameter Resource adapter.
8.Sailfin Admin console and Admin GUI support for local/remote configuration
9.TLS support.
more later….

If you have questions write to dev@sailfin.dev.java.net.

Code Generation API

softwaresutra — Wed, 24 Jun 2009 23:22:00 +0000

While I was looking at tools to generate code, I found Codemodel[codemodel.dev.java.net] to be a pretty good one. It is used by JAXB and by quite a number of internal projects within SUN. If you are not looking for a template based approach for generating JAVA code[as in http://apt-jelly.sourceforge.net/] I strongly recommend using Codemodel, nice thing I found in Codemodel is that generated code is nicely formatted , it was a onestop solution for me.

Annotations and AVP code generation tool

softwaresutra — Thu, 28 May 2009 23:00:51 +0000

As we progressed through adding features to diameter module in sailfin, we felt the need to speed up the process of adding new application support into Diameter base protocol. Inorder to enable this we added few annotations and came up with a tool that uses metadata from the dictionary to generate the huge number of AVP’s the 3GPP specs define.
Hoping to improve the tool as we progress…. Will publish the updated API’s and Annotations soon…

Support for Diameter Sh API in sailfin

softwaresutra — Mon, 13 Apr 2009 22:00:30 +0000

Sailfin project will soon support Diameter protocol and will have API’s to enable applications to use Sh,Ro,Rf functionality. As we progress towards providing Diameter support in Sailfin, we have released Sh API’s to solicit your valuable feedback. In course of time we will publish API’s for Ro and Rf applications too.
Javadocs for Sh API is published here. I will keep writing here on Sh API’, to start with let us quickly look at a simple sample on how to use Sh API in a SIP Servlet.

public class RegisterServlet extends SipServlet {
     protected void doInvite(SipServletRequest req) throws ServletException, IOException {

       ProfileData data = readUserState(req.getSubscriberURI().toString());
       SipServletResponse resp = req.createResponse(180);
       req.setExpires(2000000);
       resp.send();
     }
     private ProfileData readUserState(String user) {
      try {
        InitialContext context = new InitialContext();
        //configuration of HSS server is configured using Sailfin Admin UI.
        UserProfileServer connectionFactory = (UserProfileServer) context.lookup(“eis/SH”);
        UserProfileConnection connection = connectionFactory.createConnection();
        // Configure Key specifying information to read.
        ReadProfileKey rpk = new ReadProfileKey();
        rpk.addDataReference(DataReference.IMS_USER_STATE);
        eg:”sip:bob@open-ims.test”
        UserIdentity uID = new UserIdentity(user, UserIdentityType.PUBLIC_USER_ID);
        rpk.setUserIdentity(uID);
        //validate if the constructed key is correct and all information needed is provided.
        rpk.validate();
        //perform a read operation from HSS server in synchronous mode.
        UserProfileReadResponse urr = connection.read(rpk, false);
        ProfileData data = urr.getProfileData();
        //read the information as bytes,XMLStream or JAXBObject
        System.out.println(“User Profile data is” + new String(data.toBytes()));
        return data;
      } catch (KeyValidationException ex) {
       Logger.getLogger(RegisterServlet.class.getName()).log(Level.SEVERE, null, ex);
      } catch (ConnectException ex) {
       Logger.getLogger(RegisterServlet.class.getName()).log(Level.SEVERE, null, ex);
      } catch (NamingException ex) {
       Logger.getLogger(RegisterServlet.class.getName()).log(Level.SEVERE, null, ex);
      }
      return null;
}
}

We encourage users to look at Javadocs and provide us feedback. Please write to us at dev@sailfin.dev.java.net