microsoft.exchange.webservices.data.OutlookProtocol Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of exchange-ws-api Show documentation
Show all versions of exchange-ws-api Show documentation
The source came from http://archive.msdn.microsoft.com/ewsjavaapi
Support for Maven has been added.
The newest version!
/**************************************************************************
* copyright file="OutlookProtocol.java" company="Microsoft"
* Copyright (c) Microsoft Corporation. All rights reserved.
*
* Defines the OutlookProtocol.java.
**************************************************************************/
package microsoft.exchange.webservices.data;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
/**
* Represents a supported Outlook protocol in an Outlook configurations settings
* account.
*
*/
@EditorBrowsable(state = EditorBrowsableState.Never)
final class OutlookProtocol {
/** The Constant EXCH. */
private final static String EXCH = "EXCH";
/** The Constant EXPR. */
private final static String EXPR = "EXPR";
/** The Constant WEB. */
private final static String WEB = "WEB";
/**
* Converters to translate common Outlook protocol settings.
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>>
commonProtocolSettings =
new LazyMember>>(
new ILazyMember>>() {
public Map> createInstance() {
Map> results =
new HashMap>();
results.put(UserSettingName.EcpDeliveryReportUrlFragment,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrlMt;
}
});
results.put(UserSettingName.EcpEmailSubscriptionsUrlFragment,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrlAggr;
}
});
results.put(UserSettingName.EcpPublishingUrlFragment,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrlPublish;
}
});
results.put(UserSettingName.EcpRetentionPolicyTagsUrlFragment,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrlRet;
}
});
results.put(UserSettingName.EcpTextMessagingUrlFragment,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrlSms;
}
});
results.put(UserSettingName.EcpVoicemailUrlFragment,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrlUm;
}
});
return results;
}
});
/**
* Converters to translate internal (EXCH) Outlook protocol settings.
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>>
internalProtocolSettings =
new LazyMember>>(
new ILazyMember>>() {
public Map> createInstance() {
Map> results =
new HashMap>();
results.put(UserSettingName.ActiveDirectoryServer,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.activeDirectoryServer;
}
});
results.put(UserSettingName.CrossOrganizationSharingEnabled,
new IFunc() {
public Object func(OutlookProtocol arg) {
return String.valueOf(arg.sharingEnabled);
}
});
results.put(UserSettingName.InternalEcpUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrl;
}
});
results.put(UserSettingName.InternalEcpDeliveryReportUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlMt);
}
});
results.put(UserSettingName.InternalEcpEmailSubscriptionsUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlAggr);
}
});
results.put(UserSettingName.InternalEcpPublishingUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlPublish);
}
});
results.put(UserSettingName.InternalEcpRetentionPolicyTagsUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlRet);
}
});
results.put(UserSettingName.InternalEcpTextMessagingUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlSms);
}
});
results.put(UserSettingName.InternalEcpVoicemailUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlUm);
}
});
results.put(UserSettingName.InternalEwsUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.exchangeWebServicesUrl == null ?
arg.availabilityServiceUrl : arg.exchangeWebServicesUrl;
}
});
results.put(UserSettingName.InternalMailboxServerDN,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.serverDN;
}
});
results.put(UserSettingName.InternalRpcClientServer,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.server;
}
});
results.put(UserSettingName.InternalOABUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.offlineAddressBookUrl;
}
});
results.put(UserSettingName.InternalUMUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.unifiedMessagingUrl;
}
});
results.put(UserSettingName.MailboxDN,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.mailboxDN;
}
});
results.put(UserSettingName.PublicFolderServer,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.publicFolderServer;
}
});
return results;
}
});
/**
* Converters to translate external (EXPR) Outlook protocol settings.
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>>
externalProtocolSettings =
new LazyMember>>(
new ILazyMember>>() {
public Map> createInstance() {
Map> results =
new HashMap>();
results.put(UserSettingName.ExternalEcpDeliveryReportUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlRet);
}
});
results.put(UserSettingName.ExternalEcpEmailSubscriptionsUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlAggr);
}
});
results.put(UserSettingName.ExternalEcpPublishingUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlPublish);
}
});
results.put(UserSettingName.ExternalEcpRetentionPolicyTagsUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlRet);
}
});
results.put(UserSettingName.ExternalEcpTextMessagingUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlSms);
}
});
results.put(UserSettingName.ExternalEcpUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.ecpUrl;
}
});
results.put(UserSettingName.ExternalEcpVoicemailUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.convertEcpFragmentToUrl(arg.ecpUrlUm);
}
});
results.put(UserSettingName.ExternalEwsUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.exchangeWebServicesUrl == null ?
arg.availabilityServiceUrl : arg.exchangeWebServicesUrl;
}
});
results.put(UserSettingName.ExternalMailboxServer,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.server;
}
});
results.put(
UserSettingName.ExternalMailboxServerAuthenticationMethods,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.authPackage;
}
});
results.put(
UserSettingName.ExternalMailboxServerRequiresSSL,
new IFunc() {
public Object func(OutlookProtocol arg) {
return String.valueOf(arg.sslEnabled);
}
});
results.put(UserSettingName.ExternalOABUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.offlineAddressBookUrl;
}
});
results.put(UserSettingName.ExternalUMUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.unifiedMessagingUrl;
}
});
results.put(UserSettingName.ExchangeRpcUrl,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.exchangeRpcUrl;
}
});
return results;
}
});
/**
* Merged converter dictionary for translating
* internal (EXCH) Outlook protocol settings.
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>>
internalProtocolConverterDictionary =
new LazyMember>>(
new ILazyMember>>() {
public Map> createInstance() {
Map> results =
new HashMap>();
for (Entry> kv : commonProtocolSettings.getMember().entrySet()) {
results.put(kv.getKey(), kv.getValue());
}
for (Entry> kv : internalProtocolSettings.getMember().entrySet()) {
results.put(kv.getKey(), kv.getValue());
}
return results;
}
});
/**
* Merged converter dictionary for translating
* external (EXPR) Outlook protocol settings.
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>>
externalProtocolConverterDictionary =
new LazyMember>>(
new ILazyMember>>() {
public Map> createInstance() {
Map> results =
new HashMap>();
for (Entry> kv : commonProtocolSettings.getMember().entrySet()) {
results.put(kv.getKey(), kv.getValue());
}
for (Entry> kv : externalProtocolSettings.getMember().entrySet()) {
results.put(kv.getKey(), kv.getValue());
}
return results;
}
});
/**
* Converters to translate Web (WEB) Outlook protocol settings.
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>>
webProtocolConverterDictionary =
new LazyMember>>(
new ILazyMember>>() {
public Map> createInstance() {
Map> results =
new HashMap>();
results.put(UserSettingName.InternalWebClientUrls,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.internalOutlookWebAccessUrls;
}
});
results.put(UserSettingName.ExternalWebClientUrls,
new IFunc() {
public Object func(OutlookProtocol arg) {
return arg.externalOutlookWebAccessUrls;
}
});
return results;
}
});
/**
* Each entry maps to a lambda expression used to
* get the matching property from the OutlookProtocol instance.
*/
private static LazyMember>
availableUserSettings =
new LazyMember>(
new ILazyMember>() {
public List createInstance() {
List results =
new ArrayList();
results.addAll(commonProtocolSettings.
getMember().keySet());
results.addAll(internalProtocolSettings.
getMember().keySet());
results.addAll(externalProtocolSettings.
getMember().keySet());
results.addAll(webProtocolConverterDictionary.
getMember().keySet());
return results;
}
});
/**
* Map Outlook protocol name to type.
*/
private static LazyMember>
protocolNameToTypeMap =
new LazyMember>(
new ILazyMember>() {
@Override
public Map createInstance() {
Map results =
new HashMap();
results.put(OutlookProtocol.EXCH, OutlookProtocolType.Rpc);
results.put(OutlookProtocol.EXPR, OutlookProtocolType.RpcOverHttp);
results.put(OutlookProtocol.WEB, OutlookProtocolType.Web);
return results;
}
});
/**
* The constant activeDirectoryServer.
*/
private String activeDirectoryServer;
/**
* The constant authPackage.
*/
private String authPackage;
/**
* The constant availabilityServiceUrl.
*/
private String availabilityServiceUrl;
/**
* The constant ecpUrl.
*/
private String ecpUrl;
/**
* The constant ecpUrlAggr.
*/
private String ecpUrlAggr;
/**
* The constant ecpUrlMt.
*/
private String ecpUrlMt;
/**
* The constant ecpUrlPublish.
*/
private String ecpUrlPublish;
/**
* The constant ecpUrlRet.
*/
private String ecpUrlRet;
/**
* The constant ecpUrlSms.
*/
private String ecpUrlSms;
/**
* The constant ecpUrlUm.
*/
private String ecpUrlUm;
/**
* The constant exchangeWebServicesUrl.
*/
private String exchangeWebServicesUrl;
/**
* The constant mailboxDN.
*/
private String mailboxDN;
/**
* The constant offlineAddressBookUrl.
*/
private String offlineAddressBookUrl;
/**
* The constant exchangeRpcUrl.
*/
private String exchangeRpcUrl;
/**
* The constant publicFolderServer.
*/
private String publicFolderServer;
/**
* The constant server.
*/
private String server;
/**
* The constant serverDN.
*/
private String serverDN;
/**
* The constant unifiedMessagingUrl.
*/
private String unifiedMessagingUrl;
/**
* The constant sharingEnabled.
*/
private boolean sharingEnabled;
/**
* The constant sslEnabled.
*/
private boolean sslEnabled;
/**
* The constant externalOutlookWebAccessUrls.
*/
private WebClientUrlCollection externalOutlookWebAccessUrls;
/**
* The constant internalOutlookWebAccessUrls.
*/
private WebClientUrlCollection internalOutlookWebAccessUrls;
/**
* Initializes a new instance of the OutlookProtocol class.
*/
protected OutlookProtocol() {
this.internalOutlookWebAccessUrls = new WebClientUrlCollection();
this.externalOutlookWebAccessUrls = new WebClientUrlCollection();
}
/**
* Parses the XML using the specified reader and creates an Outlook
* protocol.
*
* @param reader
* The reader.
* @return An Outlook protocol.
* @throws Exception
* the exception
*/
protected void loadFromXml(EwsXmlReader reader)
throws Exception {
do {
reader.read();
if (reader.getNodeType().getNodeType() == XMLNodeType.START_ELEMENT) {
if (reader.getLocalName().equals(XmlElementNames.Type)) {
this.setProtocolType(OutlookProtocol.
protocolNameToType(reader.readElementValue()));
} else if (reader.getLocalName().equals(XmlElementNames.AuthPackage)) {
this.authPackage = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.Server)) {
this.server = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.ServerDN)) {
this.serverDN = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.ServerVersion)){
reader.readElementValue();
}else if (reader.getLocalName().equals(XmlElementNames.AD)){
this.activeDirectoryServer = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.MdbDN)) {
this.mailboxDN = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.EWSUrl)) {
this.exchangeWebServicesUrl = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.ASUrl)) {
this.availabilityServiceUrl = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.OOFUrl)) {
reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.UMUrl)) {
this.unifiedMessagingUrl = reader.readElementValue();
} else if (reader.getLocalName().equals(XmlElementNames.OABUrl)) {
this.offlineAddressBookUrl = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.PublicFolderServer)) {
this.publicFolderServer = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.Internal)) {
OutlookProtocol.loadWebClientUrlsFromXml(reader,
this.internalOutlookWebAccessUrls, reader.getLocalName());
} else if (reader.getLocalName().equals(
XmlElementNames.External)) {
OutlookProtocol.loadWebClientUrlsFromXml(reader,
this.externalOutlookWebAccessUrls, reader.getLocalName());
} else if (reader.getLocalName().equals(
XmlElementNames.Ssl)) {
String sslStr = reader.readElementValue();
this.sslEnabled = sslStr.equalsIgnoreCase("On");
} else if (reader.getLocalName().equals(
XmlElementNames.SharingUrl)) {
this.sharingEnabled = reader.
readElementValue().length() > 0;
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl)) {
this.ecpUrl = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl_um)) {
this.ecpUrlUm = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl_aggr)) {
this.ecpUrlAggr = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl_sms)) {
this.ecpUrlSms = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl_mt)) {
this.ecpUrlMt = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl_ret)) {
this.ecpUrlRet = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.EcpUrl_publish)) {
this.ecpUrlPublish = reader.readElementValue();
} else if (reader.getLocalName().equals(
XmlElementNames.ExchangeRpcUrl)) {
this.exchangeRpcUrl = reader.readElementValue();
} else {
reader.skipCurrentElement();
}
}
}while (!reader.isEndElement(XmlNamespace.NotSpecified,
XmlElementNames.Protocol));
}
/**
* Convert protocol name to protocol type.
* @param protocolName
* Name of the protocol.
* @return OutlookProtocolType
*/
private static OutlookProtocolType protocolNameToType(String
protocolName) {
OutlookProtocolType protocolType = null;
if(!(protocolNameToTypeMap.getMember().containsKey(protocolName))) {
protocolType = OutlookProtocolType.Unknown;
}
else {
protocolType = protocolNameToTypeMap.getMember().get(protocolName);
}
return protocolType;
}
/**
* Loads web client urls from XML.
* @param reader
* The reader.
* @param webClientUrls
* The web client urls.
* @param elementName
* Name of the element.
* @throws Exception
*/
private static void loadWebClientUrlsFromXml(EwsXmlReader reader,
WebClientUrlCollection webClientUrls, String elementName) throws Exception {
do {
reader.read();
if (reader.getNodeType().getNodeType() == XMLNodeType.START_ELEMENT) {
if(reader.getLocalName().equals(XmlElementNames.OWAUrl)) {
String authMethod = reader.readAttributeValue(
XmlAttributeNames.AuthenticationMethod);
String owaUrl = reader.readElementValue();
WebClientUrl webClientUrl =
new WebClientUrl(authMethod, owaUrl);
webClientUrls.getUrls().add(webClientUrl);
} else {
reader.skipCurrentElement();
}
}
}
while (!reader.isEndElement(XmlNamespace.NotSpecified, elementName));
}
/**
* Convert ECP fragment to full ECP URL.
* @param fragment
* The fragment.
* @return Full URL string (or null if either portion is empty.
*/
private String convertEcpFragmentToUrl(String fragment) {
return ((this.ecpUrl == null || this.ecpUrl.isEmpty()) ||
(fragment == null || fragment.isEmpty())) ? null : (this.ecpUrl + fragment);
}
/**
* Convert OutlookProtocol to GetUserSettings response.
* @param requestedSettings The requested settings.
* @param response The response.
*/
protected void convertToUserSettings(
List requestedSettings,
GetUserSettingsResponse response) {
if (this.getConverterDictionary() != null) {
// In English: collect converters that are contained in the requested settings.
Map> converterQuery =
new HashMap>();
Map> t =
this.getConverterDictionary();
for (Entry> map : t.entrySet()) {
if(requestedSettings.contains(map.getKey())) {
converterQuery.put(map.getKey(),map.getValue());
}
}
for(Entry> kv : converterQuery.entrySet())
{
Object value = kv.getValue().func(this);
if (value != null) {
response.getSettings().put(kv.getKey(), value);
}
}
}
}
private OutlookProtocolType protocolType;
/**
* Gets the type of the protocol.
*
* @return The type of the protocol.
*/
protected OutlookProtocolType getProtocolType() {
return this.protocolType;
}
/**
* Sets the type of the protocol.
*/
protected void setProtocolType(OutlookProtocolType protocolType ) {
this.protocolType = protocolType;
}
/**
* Gets the converter dictionary for protocol type.
* @return The converter dictionary.
*/
private Map>
getConverterDictionary() {
switch (this.getProtocolType()) {
case Rpc:
return internalProtocolConverterDictionary.getMember();
case RpcOverHttp:
return externalProtocolConverterDictionary.getMember();
case Web:
return webProtocolConverterDictionary.getMember();
default:
return null;
}
}
/**
* Gets the available user settings.
* @return availableUserSettings
*/
protected static List getAvailableUserSettings() {
return availableUserSettings.getMember();
}
}