Auto-wrap chained Application plugins, relax order child elements, add some logging.
[shibboleth/sp.git] / shibsp / attribute / resolver / impl / ChainingAttributeExtractor.cpp
1 /*
2  *  Copyright 2001-2010 Internet2
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *     http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 /**
18  * ChainingAttributeExtractor.cpp
19  *
20  * Chains together multiple AttributeExtractor plugins.
21  */
22
23 #include "internal.h"
24 #include "Application.h"
25 #include "ServiceProvider.h"
26 #include "attribute/Attribute.h"
27 #include "attribute/resolver/AttributeExtractor.h"
28
29 #include <xercesc/util/XMLUniDefs.hpp>
30 #include <xmltooling/util/XMLHelper.h>
31
32 using namespace shibsp;
33 using namespace opensaml::saml2md;
34 using namespace xmltooling;
35 using namespace std;
36
37 namespace shibsp {
38
39     class SHIBSP_DLLLOCAL ChainingAttributeExtractor : public AttributeExtractor
40     {
41     public:
42         ChainingAttributeExtractor(const DOMElement* e);
43         virtual ~ChainingAttributeExtractor() {
44             for_each(m_extractors.begin(), m_extractors.end(), xmltooling::cleanup<AttributeExtractor>());
45         }
46
47         Lockable* lock() {
48             return this;
49         }
50         void unlock() {
51         }
52
53         void extractAttributes(
54             const Application& application,
55             const RoleDescriptor* issuer,
56             const XMLObject& xmlObject,
57             vector<Attribute*>& attributes
58             ) const;
59
60         void getAttributeIds(vector<string>& attributes) const {
61             for (vector<AttributeExtractor*>::const_iterator i=m_extractors.begin(); i!=m_extractors.end(); ++i) {
62                 Locker locker(*i);
63                 (*i)->getAttributeIds(attributes);
64             }
65         }
66
67     private:
68         vector<AttributeExtractor*> m_extractors;
69     };
70
71     static const XMLCh _AttributeExtractor[] =  UNICODE_LITERAL_18(A,t,t,r,i,b,u,t,e,E,x,t,r,a,c,t,o,r);
72     static const XMLCh _type[] =                UNICODE_LITERAL_4(t,y,p,e);
73
74     SHIBSP_DLLLOCAL PluginManager<AttributeExtractor,string,const DOMElement*>::Factory DelegationAttributeExtractorFactory;
75     SHIBSP_DLLLOCAL PluginManager<AttributeExtractor,string,const DOMElement*>::Factory KeyDescriptorAttributeExtractorFactory;
76     SHIBSP_DLLLOCAL PluginManager<AttributeExtractor,string,const DOMElement*>::Factory XMLAttributeExtractorFactory;
77     AttributeExtractor* SHIBSP_DLLLOCAL ChainingExtractorFactory(const DOMElement* const & e)
78     {
79         return new ChainingAttributeExtractor(e);
80     }
81 };
82
83 void SHIBSP_API shibsp::registerAttributeExtractors()
84 {
85     SPConfig::getConfig().AttributeExtractorManager.registerFactory(DELEGATION_ATTRIBUTE_EXTRACTOR, DelegationAttributeExtractorFactory);
86     SPConfig::getConfig().AttributeExtractorManager.registerFactory(KEYDESCRIPTOR_ATTRIBUTE_EXTRACTOR, KeyDescriptorAttributeExtractorFactory);
87     SPConfig::getConfig().AttributeExtractorManager.registerFactory(XML_ATTRIBUTE_EXTRACTOR, XMLAttributeExtractorFactory);
88     SPConfig::getConfig().AttributeExtractorManager.registerFactory(CHAINING_ATTRIBUTE_EXTRACTOR, ChainingExtractorFactory);
89 }
90
91 AttributeExtractor::AttributeExtractor()
92 {
93 }
94
95 AttributeExtractor::~AttributeExtractor()
96 {
97 }
98
99 ChainingAttributeExtractor::ChainingAttributeExtractor(const DOMElement* e)
100 {
101     SPConfig& conf = SPConfig::getConfig();
102
103     // Load up the chain of handlers.
104     e = XMLHelper::getFirstChildElement(e, _AttributeExtractor);
105     while (e) {
106         string t(XMLHelper::getAttrString(e, nullptr, _type));
107         if (!t.empty()) {
108             try {
109                 Category::getInstance(SHIBSP_LOGCAT".AttributeExtractor.Chaining").info(
110                     "building AttributeExtractor of type (%s)...", t.c_str()
111                     );
112                 m_extractors.push_back(conf.AttributeExtractorManager.newPlugin(t.c_str(), e));
113             }
114             catch (exception& ex) {
115                 Category::getInstance(SHIBSP_LOGCAT".AttributeExtractor.Chaining").error(
116                     "caught exception processing embedded AttributeExtractor element: %s", ex.what()
117                     );
118             }
119         }
120         e = XMLHelper::getNextSiblingElement(e, _AttributeExtractor);
121     }
122 }
123
124 void ChainingAttributeExtractor::extractAttributes(
125     const Application& application, const RoleDescriptor* issuer, const XMLObject& xmlObject, vector<Attribute*>& attributes
126     ) const
127 {
128     for (vector<AttributeExtractor*>::const_iterator i=m_extractors.begin(); i!=m_extractors.end(); ++i) {
129         Locker locker(*i);
130         (*i)->extractAttributes(application, issuer, xmlObject, attributes);
131     }
132 }