/*
- * Copyright 2001-2009 Internet2
+ * Copyright 2001-2010 Internet2
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* @param lifetime if non-null, will be populated with a suggested lifetime for the cookie, or 0 if session-bound
* @return a pair containing the cookie name and the string to append to the cookie value
*/
- virtual std::pair<std::string,const char*> getCookieNameProps(const char* prefix, time_t* lifetime=NULL) const;
+ virtual std::pair<std::string,const char*> getCookieNameProps(const char* prefix, time_t* lifetime=nullptr) const;
#ifndef SHIBSP_LITE
/**
* Returns a MetadataProvider for use with this Application.
*
* @param required true iff an exception should be thrown if no MetadataProvider is available
- * @return a MetadataProvider instance, or NULL
+ * @return a MetadataProvider instance, or nullptr
*/
virtual opensaml::saml2md::MetadataProvider* getMetadataProvider(bool required=true) const=0;
* Returns a TrustEngine for use with this Application.
*
* @param required true iff an exception should be thrown if no TrustEngine is available
- * @return a TrustEngine instance, or NULL
+ * @return a TrustEngine instance, or nullptr
*/
virtual xmltooling::TrustEngine* getTrustEngine(bool required=true) const=0;
/**
* Returns an AttributeExtractor for use with this Application.
*
- * @return an AttributeExtractor, or NULL
+ * @return an AttributeExtractor, or nullptr
*/
virtual AttributeExtractor* getAttributeExtractor() const=0;
/**
* Returns an AttributeFilter for use with this Application.
*
- * @return an AttributeFilter, or NULL
+ * @return an AttributeFilter, or nullptr
*/
virtual AttributeFilter* getAttributeFilter() const=0;
/**
* Returns an AttributeResolver for use with this Application.
*
- * @return an AttributeResolver, or NULL
+ * @return an AttributeResolver, or nullptr
*/
virtual AttributeResolver* getAttributeResolver() const=0;
/**
* Returns the CredentialResolver instance associated with this Application.
*
- * @return a CredentialResolver, or NULL
+ * @return a CredentialResolver, or nullptr
*/
virtual xmltooling::CredentialResolver* getCredentialResolver() const=0;
* @deprecated
* Returns any additional audience values associated with this Application.
*
- * @return additional audience values associated with the Application, or NULL
+ * @return additional audience values associated with the Application, or nullptr
*/
virtual const std::vector<const XMLCh*>* getAudiences() const=0;
#endif
/**
* Returns the default SessionInitiator when automatically requesting a session.
*
- * @return the default SessionInitiator, or NULL
+ * @return the default SessionInitiator, or nullptr
*/
virtual const SessionInitiator* getDefaultSessionInitiator() const=0;
* Returns a SessionInitiator with a particular ID when automatically requesting a session.
*
* @param id an identifier unique to the Application
- * @return the designated SessionInitiator, or NULL
+ * @return the designated SessionInitiator, or nullptr
*/
virtual const SessionInitiator* getSessionInitiatorById(const char* id) const=0;
* Returns the default AssertionConsumerService Handler
* for use in AuthnRequest messages.
*
- * @return the default AssertionConsumerService, or NULL
+ * @return the default AssertionConsumerService, or nullptr
*/
virtual const Handler* getDefaultAssertionConsumerService() const=0;
* for use in AuthnRequest messages.
*
* @param index an index unique to an application
- * @return the designated AssertionConsumerService, or NULL
+ * @return the designated AssertionConsumerService, or nullptr
*/
virtual const Handler* getAssertionConsumerServiceByIndex(unsigned short index) const=0;
/**
+ * Returns an AssertionConsumerService Handler that supports
+ * a particular protocol "family" and optional binding.
+ *
+ * @param protocol a protocol identifier
+ * @param binding a binding identifier
+ * @return a matching AssertionConsumerService, or nullptr
+ */
+ virtual const Handler* getAssertionConsumerServiceByProtocol(const XMLCh* protocol, const char* binding=nullptr) const;
+
+ /**
+ * @deprecated
* Returns one or more AssertionConsumerService Handlers that support
* a particular protocol binding.
*
*
* @param path the PATH_INFO appended to the end of a base Handler location
* that invokes the Handler
- * @return the mapped Handler, or NULL
+ * @return the mapped Handler, or nullptr
*/
virtual const Handler* getHandler(const char* path) const=0;