View source for AppSuite:Necessary Code Changes

= Code changes necessary for Open-Xchange App Suite =

This page describes changes in the Open-Xchange Server code base which affect custom OSGI bundles interacting with our core bundles. This is important if you have custom plugins for your Open-Xchange Server systems which you are maintaining yourself.

If Open-Xchange has built and is maintaining custom packages for you, please check with your contact person at Open-Xchange when updated packages will be available.

= Backend Improvements =

Please see the page [http://oxpedia.org/wiki/index.php?title=Backend_Improvements_6_22 Backend Improvements v6.22] for an overview of improvements to the Open-Xchange architecture.

Make sure to check the section about the [http://oxpedia.org/wiki/index.php?title=Backend_Improvements_6_22#New_Exception_Framework new exception framework], many custom bundles use this and need to be changed to work with v6.22 and later.

= Authentication plugins =

Custom authentication bundles must now implement an additional method to
handle Autologin (if desired).

For this, just add

 @Override
 public Authenticated handleAutoLoginInfo(LoginInfo loginInfo) throws OXException {
      throw LoginExceptionCodes.NOT_SUPPORTED.create(MyAuthentication.class.getName());
 }


In addition, you need to return an <code>Authenticated</code> in <code>handleLoginInfo()</code>. This can be done by adding the implementation class as inner class like this:

 [...]
    private static final class AuthenticatedImpl implements Authenticated {
 
        private final String[] splitted;
 
        protected AuthenticatedImpl(String[] splitted) {
            this.splitted = splitted;
        }
 
        @Override
        public String getContextInfo() {
            return splitted[0];
        }
 
        @Override
        public String getUserInfo() {
            return splitted[1];
        }
    }
 [...]