Subversion Repositories XServices

Rev

Rev 32 | Rev 42 | Go to most recent revision | View as "text/plain" | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

/*
 *   Mylyn Connector for Serena Business Mashups
 *       Copyright 2010 Brian Rosenberger (Brutex Network)
 *
 *   Licensed under the Apache License, Version 2.0 (the "License");
 *   you may not use this file except in compliance with the License.
 *   You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software
 *   distributed under the License is distributed on an "AS IS" BASIS,
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *   See the License for the specific language governing permissions and
 *   limitations under the License.
 * 
 *   Serena, TeamTrack and Serena Business Mashup are 
 *       registered trademarks of SERENA Software Inc.
 */

package net.brutex.mylyn.sbmconnector.core;

import java.math.BigInteger;
import java.net.URL;
import java.util.ArrayList;
import java.util.Date;
import java.util.Iterator;
import java.util.List;
import java.util.StringTokenizer;

import javax.xml.namespace.QName;
import javax.xml.ws.BindingProvider;

import net.brutex.mylyn.sbmconnector.SBMConnectorPlugin;
import net.brutex.mylyn.sbmconnector.core.model.SBMField;
import net.brutex.mylyn.sbmconnector.core.model.SBMFieldTypes;
import net.brutex.mylyn.sbmconnector.core.model.SBMFieldValue;
import net.brutex.mylyn.sbmconnector.core.model.SBMNote;
import net.brutex.mylyn.sbmconnector.core.model.SBMStaticFields;
import net.brutex.sbm.wsclient.AEWebservicesFaultFault;
import net.brutex.sbm.wsclient.Aewebservices71;
import net.brutex.sbm.wsclient.Aewebservices71PortType;
import net.brutex.sbm.wsclient.Auth;
import net.brutex.sbm.wsclient.Field;
import net.brutex.sbm.wsclient.NameValue;
import net.brutex.sbm.wsclient.Note;
import net.brutex.sbm.wsclient.ObjectFactory;
import net.brutex.sbm.wsclient.TTItem;
import net.brutex.sbm.wsclient.TableData;
import net.brutex.sbm.wsclient.TableType;
import net.brutex.sbm.wsclient.Value;

import org.eclipse.core.runtime.CoreException;
import org.eclipse.mylyn.commons.net.AuthenticationCredentials;
import org.eclipse.mylyn.commons.net.AuthenticationType;
import org.eclipse.mylyn.tasks.core.RepositoryStatus;
import org.eclipse.mylyn.tasks.core.TaskRepository;

public class SBMClient {

        private Aewebservices71PortType port;
        private static final QName SERVICE_NAME = new QName("http://localhost:80/gsoap/aewebservices71.wsdl", "aewebservices71");
        private TaskRepository repository;
        private ObjectFactory of;
        private List<TableData> tables = new ArrayList<TableData>();
        
        /**
         * Instantiates a new SBM client.
         * Creates new instance of the aewebservices71 {@link net.brutex.sbm.wsclient.ObjectFactory} and
         * initializes web service endpoint from repository url.
         *
         * @param repository the repository
         */
        public SBMClient(TaskRepository repository) {
                this.repository = repository;
                this.of = new ObjectFactory();
                
        URL wsdlURL = Aewebservices71.WSDL_LOCATION;
                wsdlURL = this.getClass().getResource("/META-INF/aewebservices71.wsdl");
        Aewebservices71 ss = new Aewebservices71(wsdlURL, SERVICE_NAME);
        port = ss.getAewebservices71();
        ((BindingProvider)port).getRequestContext().put(
                        BindingProvider.ENDPOINT_ADDRESS_PROPERTY,
                        repository.getRepositoryUrl());
        }
        
        /**
         * Can authenticate checks if this SBMClient instance has proper authentication details
         * set in its related repository. The check is done by invoking the GetUser web service.
         *
         * @return true, if successful
         * @throws CoreException the core exception
         */
        public boolean canAuthenticate() throws CoreException {
                try {
                        port.getUser(getAuth(), repository.getCredentials(AuthenticationType.REPOSITORY).getUserName());
                } catch (AEWebservicesFaultFault e) {
                        new CoreException(RepositoryStatus.createLoginError(
                                        repository.getRepositoryUrl(), SBMConnectorPlugin.PLUGIN_ID));
                        return false;
                }
                return true;
        }
        
        /**
         * Gets the SBM items from a table. The result size is limited to 500 and the sorting is done
         * by submit date descending.
         *
         * @param tablename the tablename
         * @param sql_where the sql_where
         * @return the tT items by table
         * @throws CoreException the core exception
         */
        public List<TTItem> getTTItemsByTable(String tablename, String sql_where) throws CoreException {
                List<TTItem> list = new ArrayList<TTItem>();
                if(sql_where==null || sql_where.isEmpty()) sql_where = "TS_ID>0";
                try {
                        list = port.getItemsByQueryWithName(
                                        getAuth(), 
                                        tablename, 
                                        "("+sql_where+")",
                                        "TS_SUBMITDATE desc",
                                        BigInteger.valueOf(500l), null);
                } catch (AEWebservicesFaultFault e) {
                        new CoreException(
                                        RepositoryStatus.createInternalError(
                                                        SBMConnectorPlugin.PLUGIN_ID, e.getFaultInfo(), e));
                }
                return list;
        }
        
        /**
         * Gets a SBM item specified by its internal identifier ([tableid:recordid])
         *
         * @param itemid the itemid
         * @return the tT item
         */
        public TTItem getTTItem(String itemid) {
                TTItem item = of.createTTItem();
                        try {
                                item = port.getItem(getAuth(), itemid, null);
                        } catch (AEWebservicesFaultFault e) {
                                new CoreException(
                                                RepositoryStatus.createInternalError(
                                                                SBMConnectorPlugin.PLUGIN_ID, e.getFaultInfo(), e));
                        }
                        return item;
        }
        

        
        private Auth getAuth() {
                Auth auth = of.createAuth();
                AuthenticationCredentials credentials = repository.getCredentials(AuthenticationType.REPOSITORY);
                auth.setUserId(of.createAuthUserId(credentials.getUserName()));
                auth.setPassword(of.createAuthPassword(credentials.getPassword()));     
                return auth;
        }

        /**
         * Gets the field value for a system generic field.
         *
         * @param ttitem the ttitem
         * @param fieldname the fieldname
         * @return the static field value
         */
        public String getStaticFieldValue(TTItem ttitem, String fieldname) {
                if(fieldname.equals(SBMStaticFields.SUBMITDATE.getValue())) {
                        Date date = ttitem.getCreateDate().getValue().toGregorianCalendar().getTime();
                        return String.valueOf(date.getTime());
                }
                if(fieldname.equals(SBMStaticFields.LASTMODIFIEDDATE.getValue())) {
                        return String.valueOf(ttitem.getModifiedDate().getValue().toGregorianCalendar().getTimeInMillis());
                }
                if(fieldname.equals("TITLE")) {
                        if(ttitem.getTitle()==null || ttitem.getTitle().isNil()) return "";
                        return ttitem.getTitle().getValue();
                }
                if(fieldname.equals(SBMStaticFields.ISSUEID.getValue())) {
                        if(ttitem.getGenericItem()==null || ttitem.getGenericItem().getValue().getItemName()==null) {
                                return "";
                        }
                        return ttitem.getGenericItem().getValue().getItemName().getValue();
                }
                if(fieldname.equals("ISSUETYPE")) {
                        if(ttitem.getItemType()==null || ttitem.getItemType().isNil()) return "";
                        return ttitem.getItemType().getValue();
                }
                if(fieldname.equals(SBMStaticFields.STATE.getValue())) {
                        if(ttitem.getState()==null || ttitem.getState().isNil()) return "";
                        return ttitem.getState().getValue();
                }
                if(fieldname.equals(SBMStaticFields.ID.getValue())) {
                        return ttitem.getGenericItem().getValue().getItemName().getValue()+
                        " ["+ttitem.getGenericItem().getValue().getItemID().getValue()+"]";
                }
                if(fieldname.equals(SBMStaticFields.PROJECTID.getValue())) {
                        if(ttitem.getClassification() ==null || ttitem.getClassification().isNil()) return "";
                        return ttitem.getClassification().getValue();
                }
                if(fieldname.equals(SBMStaticFields.PROJECTUUID.getValue())) {
                        if(ttitem.getClassificationUUID()==null || ttitem.getClassificationUUID().isNil()) return "";
                        return ttitem.getClassificationUUID().getValue();
                }
                if(fieldname.equals("DESCRIPTION")) {
                        if(ttitem.getDescription() == null || ttitem.getDescription().isNil()) return "";
                        return ttitem.getDescription().getValue();
                } 
                if(fieldname.equals(SBMStaticFields.SUBMITTER.getValue())) {
                        if(ttitem.getCreatedBy()==null || ttitem.getCreatedBy().isNil()) return "";
                        return ttitem.getCreatedBy().getValue();
                }
                if(fieldname.equals(SBMStaticFields.SUBMITDATE.getValue())) {
                        return String.valueOf(ttitem.getCreateDate().getValue().toGregorianCalendar().getTimeInMillis());
                }
                if(fieldname.equals(SBMStaticFields.LASTMODIFIER.getValue())) {
                        if(ttitem.getModifiedBy()==null || ttitem.getModifiedBy().isNil()) return "";
                        return ttitem.getModifiedBy().getValue();
                }
                if(fieldname.equals(SBMStaticFields.LASTMODIFIEDDATE.getValue())) {
                        return String.valueOf(ttitem.getModifiedDate().getValue().toGregorianCalendar().getTimeInMillis());
                }
                if(fieldname.equals(SBMStaticFields.ACTIVEINACTIVE.getValue())) {
                        return ttitem.getActiveInactive().getValue();
                }
                if(fieldname.equals(SBMStaticFields.OWNER.getValue())) {
                        return ttitem.getOwner().getValue();
                }
                if(fieldname.equals(SBMStaticFields.ITEMURL.getValue())) {
                        return ttitem.getUrl().getValue();
                }
                if(fieldname.equals(SBMStaticFields.UUID.getValue())) {
                        return ttitem.getGenericItem().getValue().getItemUUID().getValue();
                }
                if(fieldname.equals(SBMStaticFields.CLOSEDATE.getValue())) {
                        Iterator<NameValue> list = ttitem.getExtendedFieldList().iterator();
                        while (list.hasNext()) {
                                NameValue field = list.next();
                                if(field.getName().getValue().equals("CLOSEDATE")) {
                                        return field.getValue().getValue().getInternalValue().getValue();
                                }
                        }
                }
                if(fieldname.equals(SBMStaticFields.LASTSTATECHANGEDATE.getValue())) {
                        Iterator<NameValue> list = ttitem.getExtendedFieldList().iterator();
                        while (list.hasNext()) {
                                NameValue field = list.next();
                                if(field.getName().getValue().equals("LASTSTATECHANGEDATE")) {
                                        return field.getValue().getValue().getInternalValue().getValue();
                                }
                        }
                }
                if(fieldname.equals(SBMStaticFields.SECONDARYOWNER.getValue())) {
                        Iterator<NameValue> list = ttitem.getExtendedFieldList().iterator();
                        while (list.hasNext()) {
                                NameValue field = list.next();
                                if(field.getName().getValue().equals("SECONDARYOWNER")) {
                                        return field.getValue().getValue().getInternalValue().getValue();
                                }
                        }
                }
                if(fieldname.equals(SBMStaticFields.LASTSTATECHANGER.getValue())) {
                        Iterator<NameValue> list = ttitem.getExtendedFieldList().iterator();
                        while (list.hasNext()) {
                                NameValue field = list.next();
                                if(field.getName().getValue().equals("LASTSTATECHANGER")) {
                                        return field.getValue().getValue().getDisplayValue().getValue();
                                }
                        }
                }

                return "UNKNOWN";
        }
        
        /**
         * Gets the field label. The SBM item is used to determine the table id of 
         * the table where this field is in.
         *
         * @param ttitem the ttitem
         * @param fieldname the fieldname
         * @return the field label
         */
        public String getFieldLabel(TTItem ttitem, String fieldname) {
                refreshTables();
                String itemid = ttitem.getGenericItem().getValue().getItemID().getValue();
                String tableid = new StringTokenizer(itemid, ":").nextToken();
                for (TableData table : tables) {
                        if (String.valueOf(table.getTableID().intValue()).equals(tableid)) {
                                Iterator<Field> iter = table.getFieldList().iterator();
                                while(iter.hasNext()) {
                                        Field f = iter.next();
                                        if(f.getName().getValue().equals(fieldname)) {
                                                return f.getDisplayName().getValue();
                                        }
                                }
                                break;
                        }
                }
        return "label_UNKNOWN";
        }
        
        /**
         * Gets the table database name.
         *
         * @param ttitem the ttitem
         * @return the table name or null in case table is not found
         */
        public String getTableName(TTItem ttitem) {
                refreshTables();
                String itemid = ttitem.getGenericItem().getValue().getItemID().getValue();
                String tableid = new StringTokenizer(itemid, ":").nextToken();
                for (TableData table : tables) {
                        if (String.valueOf(table.getTableID().intValue()).equals(tableid)) {
                                return table.getName().getValue();
                        }
                }
                return null;
        }
        
        /**
         * Gets the notes attached to a SBM item.
         *
         * @param ttitem the ttitem
         * @return the notes
         */
        public List<SBMNote> getNotes(TTItem ttitem) {
                List<SBMNote> notes = new ArrayList<SBMNote>();
                Iterator<Note> iter = ttitem.getNoteList().iterator();
                while(iter.hasNext()) {
                        Note n = iter.next();
                        SBMNote note = new SBMNote("sbm_user", 
                                        n.getTitle().getValue()+"\n"+n.getNote().getValue(),
                                        n.getModificationDateTime().toGregorianCalendar().getTime(),
                                        n.getId().toString());
                        notes.add(note);
                }
                return notes;
        }

        
        /**
         * Gets the names of all available primary tables.
         * A table name is a unique reference within one SBM environment, thus can be
         * used as a key.
         *
         * @return the primary table names as a list
         */
        public List<String> getPrimaryTables() {
                refreshTables();
                List<String> table_names = new ArrayList<String>();
                for (TableData table : tables) {
                        table_names.add(table.getName().getValue());
                }
                return table_names;
        }
        
        /**
         * Refresh table specifications from SBM web service. This
         * is only done once per SBMClient instance.
         */
        private void refreshTables() {
                if (tables.isEmpty()) {
                        try {
                                //currently we limit this to primary tables
                                tables = port.getTables(getAuth(), null, TableType.PRIMARY_TABLE);
                        } catch (AEWebservicesFaultFault e) {
                                new CoreException(
                                                RepositoryStatus.createInternalError(
                                                                SBMConnectorPlugin.PLUGIN_ID, e.getFaultInfo(), e));
                        }
                }
        }
        
        /**
         * Gets the fields for a primary table
         *
         * @param tablename the table database name
         * @return the fields, empty when table does not exist
         */
        public List<SBMField> getFields(String tablename) {
                refreshTables();
                List<SBMField> fields = new ArrayList<SBMField>();
                for (TableData table : tables) {
                        if(table.getName().getValue().equals(tablename)) {
                                Iterator<Field> iter = table.getFieldList().iterator();
                                while(iter.hasNext()) {
                                        Field f = iter.next();
                                        SBMField nf = new SBMField(
                                                        SBMFieldTypes.fromValue(f.getFieldType().value()),
                                                        tablename,
                                                        f.getDisplayName().getValue(),
                                                        f.getName().getValue());
                                        fields.add(nf);
                                }
                                break;
                        }
                }
                return fields;
        }
        
        /**
         * Gets the field value for custom defined field.
         * (those from &lt;extendedFieldList&gt;)
         *
         * @param ttitem the ttitem
         * @param fieldname the fieldname
         * @return the field value or null if the field is not found
         */
        public SBMFieldValue getFieldValue(TTItem ttitem, String fieldname) {
                SBMFieldValue value;
                Iterator<NameValue> fs = ttitem.getExtendedFieldList().iterator();
                while(fs.hasNext()) {
                        NameValue nv = fs.next();
                        if(nv.getName().getValue().equals(fieldname)) {
                                if (nv.getValue()!=null && !nv.getValue().isNil()) {
                                        value = new SBMFieldValue(
                                                        nv.getValue().getValue().getInternalValue().getValue(),
                                                        nv.getValue().getValue().getDisplayValue().getValue());
                                        return value;
                                }
                        }
                }
                return null;
        }
        
        /**
         * Gets the field values for custom defined, multi type field.
         * (those from &lt;extendedFieldList&gt;)
         *
         * @param ttitem the ttitem
         * @param fieldname the fieldname
         * @return the list of field values
         */
        public List<SBMFieldValue> getFieldValues(TTItem ttitem, String fieldname) {
                List<SBMFieldValue> values = new ArrayList<SBMFieldValue>();
                Iterator<NameValue> fs = ttitem.getExtendedFieldList().iterator();
                while(fs.hasNext()) {
                        NameValue nv = fs.next();
                        if(nv.getName().getValue().equals(fieldname)) {
                                if (nv.getValues()!=null && !nv.getValues().isEmpty()) {
                                        Iterator<Value> nvv = nv.getValues().iterator();
                                        while(nvv.hasNext()) {
                                                Value nvv_value = nvv.next();                   
                                                SBMFieldValue value = new SBMFieldValue(
                                                        nvv_value.getInternalValue().getValue(),
                                                        nvv_value.getDisplayValue().getValue());
                                                values.add(value);
                                        }
                                        return values;
                                }
                        }
                }
                return values;
        }

        public List<SBMFieldValue> getValidSet(String tablename, String fieldname) {
                List<SBMFieldValue> list = new ArrayList<SBMFieldValue>();
                List<TTItem> ttlist = new ArrayList<TTItem>();
                String sql = "TS_ID in (select max(TS_ID) from "+tablename+" group by ts_"+fieldname+")";
                try {
                        ttlist = getTTItemsByTable(tablename, sql);
                } catch (CoreException e) {
                        new CoreException(
                                        RepositoryStatus.createInternalError(
                                                        SBMConnectorPlugin.PLUGIN_ID, e.getMessage(), e));
                }
                for(TTItem ttitem : ttlist) {
                        list.add(getFieldValue(ttitem, fieldname));
                }
                
                return list;            
        }
}