Everyday Git (Git commands you need in your everyday work)

Git [1] is one of the most popular version control systems. In this post I am going to show you how to work with GitHub [2]. When it comes to GitHub there are thousands of public repositories. If you are interested in a project you can start working on it and contributing it. Followings are the steps and commands you will have to use while you work with GitHub.

1. Forking a repository
This is done via the GithHub [2] web site.

2. Clone a new repository

git clone https://github.com/jsdjayanga/carbon4-kernel.git

3. Get updates from the remote repository (origin/master)

git pull origin master

4. Push the updates to the the remote repository (origin/master)

git push origin master

5. Add updated files to staging

git add TestFile.java

6. Commit the local changes to the remote repository

git commit -m "Modifications to TestFile.java" --signoff

7. Set the upstream repository

git remote add upstream https://github.com/wso2/carbon4-kernel.git

8. Fetch from upstream repository

git fetch upstream

9. Fetch from all the remote repositories

git fetch --all

10. Merge new changes from upstream repository for the master branch

git checkout master
git merge upstream/master

11. Merge new changes from upstream repository for the "otherbranch" branch

git checkout otherbranch
git merge upstream/otherbranch

12. View the history of commits

git log

13. If needed to discard some commits in the local repository
First find the commit ID to which you want to revert back to. The user the following command

git reset --hard #commitId

14. To tag a particular commit

git checkout #commitid
git tag -a v1.1.1 -m 'Tagging version v1.1.1'
git push origin --tags

[1] http://git-scm.com/
[2] https://github.com/

WSO2 Carbon : Get notified just after the server start and just before server shutdown

WSO2 Carbon [1] is a 100% open source, integrated and componentized middleware platform which enables you to develop your business and enterprise solutions rapidly. WSO2 Carbon is based on OSGi framework [2]. It inherits molecularity and dynamism from the OSGi.

In this post I am going to show you how to get notified, when the server is starting up and when the server is about to shut down. 

In OSGi, bundle start up sequence is random. So you can't rely on the bundle start up sequence.

There are real world scenarios where you have some dependencies amount bundles, hence need to perform some actions before other dependent bundles get deactivated in the server shutdown.

Eg. Let's say you have to send messages to a external system. Your message sending module use your authentication module to authenticate the request and send it to the external system and your message sending module try to send all the buffered messages before the server shutdown.

Bundle unloading sequence in OSGi not happened in a guaranteed sequence. So, what would happen if your authentication bundle get deactivated before your message sending bundle get deactivated. In this case message sending module can't send the messages

To help these type of scenarios WSO2 Carbon framework provide you with a special OSGi service which can be used to detect the server start up and server shutdown

1. How to get notified the server startup

Implement the interface org.wso2.carbon.core.ServerStartupObserver [3], and register it as a service via the bundle context.

When the server is starting you will receive notifications via completingServerStartup() and completedServerStartup()


2. How to get notified the server shutdown

Implement the interface org.wso2.carbon.core.ServerShutdownHandler [4], and register it as a service via the bundle context.

When the server is about to shutdown you will receive the notification via invoke()

eg:

1 2 3 4 5 6 7

protected void activate(ComponentContext componentContext) { try { componentContext.getBundleContext().registerService(ServerStartupObserver.class.getName(), new CustomServerStartupObserver(), null) ; } catch (Throwable e) { log.error("Failed to activate the bundle ", e); } }

[1] http://wso2.com/products/carbon/
[2] http://www.osgi.org/Main/HomePage

[3] https://github.com/wso2/carbon4-kernel/blob/master/core/org.wso2.carbon.core/src/main/java/org/wso2/carbon/core/ServerStartupObserver.java
[4] https://github.com/wso2/carbon4-kernel/blob/master/core/org.wso2.carbon.core/src/main/java/org/wso2/carbon/core/ServerShutdownHandler.java