net.shibboleth.idp.ui.context

Class RelyingPartyUIContext

java.lang.Object

org.opensaml.messaging.context.BaseContext

net.shibboleth.idp.ui.context.RelyingPartyUIContext

All Implemented Interfaces:

Iterable<org.opensaml.messaging.context.BaseContext>

public class RelyingPartyUIContext
extends org.opensaml.messaging.context.BaseContext

The context which carries the user interface information.

Nested Class Summary

Nested classes/interfaces inherited from class org.opensaml.messaging.context.BaseContext

org.opensaml.messaging.context.BaseContext.ContextSetNoRemoveIteratorDecorator

Field Summary

Fields

Modifier and Type	Field and Description
private List<String>	browserLanguages The languages that this browser wants to know about.
private Logger	log The log.
private org.opensaml.saml.saml2.metadata.AttributeConsumingService	rpAttributeConsumingService The appropriate AttributeConsumingService.
private org.opensaml.saml.saml2.metadata.EntityDescriptor	rpEntityDescriptor The appropriate EntityDescriptor.
private org.opensaml.saml.saml2.metadata.SPSSODescriptor	rpSPSSODescriptor The appropriate SPSSODescriptor.
private org.opensaml.saml.ext.saml2mdui.UIInfo	rpUIInfo The appropriate UIInfo.

Constructor Summary

Constructors

Constructor and Description
RelyingPartyUIContext() Constructor.

Method Summary

Modifier and Type	Method and Description
protected List<String>	getBrowserLanguages() Get the browser languages.
String	getContactEmail(String contactType) look for the <ContactPerson> and within that the Email.
String	getContactGivenName(String contactType) look for the <ContactPerson> and within that the GivenName.
org.opensaml.saml.saml2.metadata.ContactPerson	getContactPerson(org.opensaml.saml.saml2.metadata.ContactPersonTypeEnumeration contactType) Lookup the specified type of Contact in the RP metadata.
String	getContactSurName(String contactType) look for the <ContactPerson> and within that the SurName.
protected org.opensaml.saml.saml2.metadata.ContactPersonTypeEnumeration	getContactType(String type) Parser for the contact type.
protected String	getDescriptionFromAttributeConsumingService(String lang) look for an <AttributeConsumeService> and if its there look for an appropriate description.
protected String	getDescriptionFromUIInfo(String lang) look at <UIInfo> if there and if so look for appropriate description.
String	getInformationURL() Get the <mdui:InformationURL>.
String	getLogo() Get the Logo (or null).
String	getLogo(int minWidth, int minHeight, int maxWidth, int maxHeight) Get the Logo (or null).
String	getLogo(String minWidth, String minHeight, String maxWidth, String maxHeight) Get the Logo (or null).
private String	getLogoByLanguage(String lang, int minWidth, int minHeight, int maxWidth, int maxHeight) Get the Logo of the given language which fits the size.
private String	getLogoNoLanguage(int minWidth, int minHeight, int maxWidth, int maxHeight) Get the Logo of the given language which fits the size.
protected String	getNameFromAttributeConsumingService(String lang) Look for an <AttributeConsumeService> and if its there look for an appropriate name.
protected String	getNameFromEntityId() If the entityId can look like a host return that, otherwise the entityId in full.
protected String	getNameFromUIInfo(String lang) look at <UIinfo>; if there and if so look for appropriate name.
protected org.opensaml.saml.saml2.metadata.Organization	getOrganization() Get the Organization from the SPSSODescriptor, failing that the EntityDescriptor.
String	getOrganizationDisplayName() Look for the <OrganizationDisplayName>.
String	getOrganizationName() Look for the <OrganizationName>.
String	getOrganizationURL() * Look for the <OrganizationURL>.
String	getPrivacyStatementURL() Get the <mdui:PrivacyStatementURL>.
protected org.opensaml.saml.saml2.metadata.AttributeConsumingService	getRPAttributeConsumingService() Get the AttributeConsumingService for the request.
protected org.opensaml.saml.saml2.metadata.EntityDescriptor	getRPEntityDescriptor() Get the EntityDescriptor.
protected org.opensaml.saml.saml2.metadata.SPSSODescriptor	getRPSPSSODescriptor() Get the SPSSODescriptor.
protected org.opensaml.saml.ext.saml2mdui.UIInfo	getRPUInfo() Get the RP UIInfo associated with the request.
String	getServiceDescription() Get the service Description.
String	getServiceName() Get the service name.
private boolean	logoFits(org.opensaml.saml.ext.saml2mdui.Logo logo, int minWidth, int minHeight, int maxWidth, int maxHeight) Does the logo fit the supplied parameters?
private String	policeURL(String url, List<String> acceptableSchemes) Check to see whether a supplied URL is acceptable, returning the default if it isn't.
protected String	policeURLLogo(String url) Police a url found for a logo.
protected String	policeURLNonLogo(String url) Police a url found for non logo data.
RelyingPartyUIContext	setBrowserLanguages(List<String> languages) Set the browser languages.
RelyingPartyUIContext	setRPAttributeConsumingService(org.opensaml.saml.saml2.metadata.AttributeConsumingService what) Set the AttributeConsumingService for the request.
RelyingPartyUIContext	setRPEntityDescriptor(org.opensaml.saml.saml2.metadata.EntityDescriptor what) Set the EntityDescriptor.
RelyingPartyUIContext	setRPSPSSODescriptor(org.opensaml.saml.saml2.metadata.SPSSODescriptor what) Set the SPSSODescriptor.
RelyingPartyUIContext	setRPUInfo(org.opensaml.saml.ext.saml2mdui.UIInfo what) Set the RP UIInfo associated with the request.

Methods inherited from class org.opensaml.messaging.context.BaseContext

addSubcontext, addSubcontext, clearSubcontexts, containsSubcontext, createSubcontext, getParent, getSubcontext, getSubcontext, getSubcontext, getSubcontext, isAutoCreateSubcontexts, iterator, removeSubcontext, removeSubcontext, setAutoCreateSubcontexts, setParent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

log

@Nonnull
private final Logger log

The log.

rpEntityDescriptor

@Nullable
private org.opensaml.saml.saml2.metadata.EntityDescriptor rpEntityDescriptor

The appropriate EntityDescriptor.

rpSPSSODescriptor

@Nullable
private org.opensaml.saml.saml2.metadata.SPSSODescriptor rpSPSSODescriptor

The appropriate SPSSODescriptor.

rpAttributeConsumingService

@Nullable
private org.opensaml.saml.saml2.metadata.AttributeConsumingService rpAttributeConsumingService

The appropriate AttributeConsumingService.

rpUIInfo

@Nullable
private org.opensaml.saml.ext.saml2mdui.UIInfo rpUIInfo

The appropriate UIInfo.

browserLanguages

@Nonnull
 @NonnullElements
private List<String> browserLanguages

The languages that this browser wants to know about.

Constructor Detail

RelyingPartyUIContext

public RelyingPartyUIContext()

Constructor.

Method Detail

getRPEntityDescriptor

@Nullable
protected org.opensaml.saml.saml2.metadata.EntityDescriptor getRPEntityDescriptor()

Get the EntityDescriptor.

Returns:

Returns the entity.

setRPEntityDescriptor

@Nonnull
public RelyingPartyUIContext setRPEntityDescriptor(@Nullable
                                                            org.opensaml.saml.saml2.metadata.EntityDescriptor what)

Set the EntityDescriptor.

Parameters:

what - what to set

Returns:

this context

getRPSPSSODescriptor

@Nullable
protected org.opensaml.saml.saml2.metadata.SPSSODescriptor getRPSPSSODescriptor()

Get the SPSSODescriptor.

Returns:

Returns the SPSSODescriptor.

setRPSPSSODescriptor

@Nonnull
public RelyingPartyUIContext setRPSPSSODescriptor(@Nullable
                                                           org.opensaml.saml.saml2.metadata.SPSSODescriptor what)

Set the SPSSODescriptor.

Parameters:

what - what to set

Returns:

this context

getRPAttributeConsumingService

@Nullable
protected org.opensaml.saml.saml2.metadata.AttributeConsumingService getRPAttributeConsumingService()

Get the AttributeConsumingService for the request.

Returns:

Returns the SPSSODescriptor.

getRPUInfo

@Nullable
protected org.opensaml.saml.ext.saml2mdui.UIInfo getRPUInfo()

Get the RP UIInfo associated with the request.

Returns:

the value or null if there is none.

setRPUInfo

@Nonnull
public RelyingPartyUIContext setRPUInfo(@Nullable
                                                 org.opensaml.saml.ext.saml2mdui.UIInfo what)

Set the RP UIInfo associated with the request.

Parameters:

what - the value to set

Returns:

this context

setRPAttributeConsumingService

@Nonnull
public RelyingPartyUIContext setRPAttributeConsumingService(@Nullable
                                                                     org.opensaml.saml.saml2.metadata.AttributeConsumingService what)

Set the AttributeConsumingService for the request.

Parameters:

what - what to set

Returns:

this context

setBrowserLanguages

@Nonnull
public RelyingPartyUIContext setBrowserLanguages(@Nonnull @NonnullElements
                                                          List<String> languages)

Set the browser languages.

Parameters:

languages - the languages to set

Returns:

this context

getBrowserLanguages

@Nonnull
 @NonnullElements
protected List<String> getBrowserLanguages()

Get the browser languages.

Returns:

the languages.

policeURL

@Nullable
private String policeURL(@Nullable
                                   String url,
                                   @Nonnull @NotEmpty
                                   List<String> acceptableSchemes)

Check to see whether a supplied URL is acceptable, returning the default if it isn't.

Parameters:

url - the url to look at

acceptableSchemes - the schemes to test against

Returns:

the input or null as appropriate.

policeURLLogo

protected String policeURLLogo(@Nullable
                               String url)

Police a url found for a logo.

Parameters:

url - the url to look at

Returns:

the input or the default as appropriate

policeURLNonLogo

protected String policeURLNonLogo(@Nullable
                                  String url)

Police a url found for non logo data.

Parameters:

url - the url to look at

Returns:

the input or the default as appropriate

getNameFromUIInfo

@Nullable
protected String getNameFromUIInfo(String lang)

look at <UIinfo>; if there and if so look for appropriate name.

Parameters:

lang - - which language to look up

Returns:

null or an appropriate name

getNameFromAttributeConsumingService

@Nullable
protected String getNameFromAttributeConsumingService(String lang)

Look for an <AttributeConsumeService> and if its there look for an appropriate name.

Parameters:

lang - - which language to look up

Returns:

null or an appropriate name

getNameFromEntityId

@Nullable
protected String getNameFromEntityId()

If the entityId can look like a host return that, otherwise the entityId in full.

Returns:

either the host or the entityId.

getDescriptionFromUIInfo

@Nullable
protected String getDescriptionFromUIInfo(String lang)

look at <UIInfo> if there and if so look for appropriate description.

Parameters:

lang - - which language to look up

Returns:

null or an appropriate description

getDescriptionFromAttributeConsumingService

@Nullable
protected String getDescriptionFromAttributeConsumingService(String lang)

look for an <AttributeConsumeService> and if its there look for an appropriate description.

Parameters:

lang - - which language to look up

Returns:

null or an appropriate description

getOrganization

@Nullable
protected org.opensaml.saml.saml2.metadata.Organization getOrganization()

Get the Organization from the SPSSODescriptor, failing that the EntityDescriptor.

Returns:

the Organization for the relying party.

getContactType

protected org.opensaml.saml.saml2.metadata.ContactPersonTypeEnumeration getContactType(@Nullable
                                                                                       String type)

Parser for the contact type.

Parameters:

type - in value

Returns:

the enumeration type. suitably defaulted.

getContactPerson

@Nullable
public org.opensaml.saml.saml2.metadata.ContactPerson getContactPerson(org.opensaml.saml.saml2.metadata.ContactPersonTypeEnumeration contactType)

Lookup the specified type of Contact in the RP metadata.

Parameters:

contactType - what type to look up.

Returns:

the ContactPerson or null.

getServiceName

@Nullable
public String getServiceName()

Get the service name.

Returns:

the name or null if there wasn't one

getServiceDescription

@Nullable
public String getServiceDescription()

Get the service Description.

Returns:

the description or null if there wasn't one

getOrganizationDisplayName

@Nullable
public String getOrganizationDisplayName()

Look for the <OrganizationDisplayName>.

Returns:

An appropriate string or null

getOrganizationName

@Nullable
public String getOrganizationName()

Look for the <OrganizationName>.

Returns:

An appropriate string or null

getOrganizationURL

public String getOrganizationURL()

* Look for the <OrganizationURL>.

Returns:

An appropriate string or the null

getContactSurName

@Nullable
public String getContactSurName(@Nullable
                                          String contactType)

look for the <ContactPerson> and within that the SurName.

Parameters:

contactType - the type of contact to look for

Returns:

An appropriate string or null

getContactGivenName

@Nullable
public String getContactGivenName(@Nullable
                                            String contactType)

look for the <ContactPerson> and within that the GivenName.

Parameters:

contactType - the type of contact to look for

Returns:

An appropriate string or null

getContactEmail

@Nullable
public String getContactEmail(@Nullable
                                        String contactType)

look for the <ContactPerson> and within that the Email.

Parameters:

contactType - the type of contact to look for

Returns:

An appropriate string or null

getInformationURL

@Nullable
public String getInformationURL()

Get the <mdui:InformationURL>.

Returns:

the value or the default value

getPrivacyStatementURL

@Nullable
public String getPrivacyStatementURL()

Get the <mdui:PrivacyStatementURL>.

Returns:

the value or null

logoFits

private boolean logoFits(org.opensaml.saml.ext.saml2mdui.Logo logo,
                         int minWidth,
                         int minHeight,
                         int maxWidth,
                         int maxHeight)

Does the logo fit the supplied parameters?

Parameters:

logo - the logo

minWidth - min Width

minHeight - min Height

maxWidth - max Width

maxHeight - max Height

Returns:

whether it fits

getLogoByLanguage

@Nullable
private String getLogoByLanguage(@Nonnull
                                           String lang,
                                           int minWidth,
                                           int minHeight,
                                           int maxWidth,
                                           int maxHeight)

Get the Logo of the given language which fits the size.

Parameters:

lang - the language

minWidth - the minimum width to allow.

minHeight - the minimum height to allow.

maxWidth - the maximum width to allow.

maxHeight - the maximum height to allow.

Returns:

an appropriate logo URL or null.

getLogoNoLanguage

@Nullable
private String getLogoNoLanguage(int minWidth,
                                           int minHeight,
                                           int maxWidth,
                                           int maxHeight)

Get the Logo of the given language which fits the size.

Parameters:

minWidth - the minimum width to allow.

minHeight - the minimum height to allow.

maxWidth - the maximum width to allow.

maxHeight - the maximum height to allow.

Returns:

an appropriate logo URL or null.

getLogo

@Nullable
public String getLogo(int minWidth,
                                int minHeight,
                                int maxWidth,
                                int maxHeight)

Get the Logo (or null). We apply the languages and the supplied lengths.

Parameters:

minWidth - the minimum width to allow.

minHeight - the minimum height to allow.

maxWidth - the maximum width to allow.

maxHeight - the maximum height to allow.

Returns:

an appropriate logo URL or null.

getLogo

@Nullable
public String getLogo(String minWidth,
                                String minHeight,
                                String maxWidth,
                                String maxHeight)

Get the Logo (or null). We apply the languages and the supplied lengths.

Parameters:

minWidth - the minimum width to allow.

minHeight - the minimum height to allow.

maxWidth - the maximum width to allow.

maxHeight - the maximum height to allow.

Returns:

an appropriate logo URL or null.

getLogo

@Nullable
public String getLogo()

Get the Logo (or null). We apply the languages. Any size works.

Returns:

an appropriate logo URL or null.