summaryrefslogtreecommitdiff
path: root/src/com/memberwebs/ldapxml/LXMap.java
blob: 332ce07b687f2747e31aef0cc0461b9beaed359d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
package com.memberwebs.ldapxml;

import java.io.*;
import java.util.*;

import org.xml.sax.*;
import org.xml.sax.helpers.*;

import com.memberwebs.ldapxml.helpers.*;

/**
 * The in memory representation of an LX map.
 *
 * @author nielsen@memberwebs.com
 * @version 0.5
 */
public class LXMap
{
    /**
     * Constructs a new LXMap object.
     */
    public LXMap()
    {
        m_root = null;
        m_nameMap = null;
        m_nameSet = null;
    }

    /**
     * Get the root node of the LX map.
     *
     * @return The root.
     */
    protected final LXRoot getRoot()
    {
        return m_root;
    }


    /**
     * Load an LX map from an XML data stream
     *
     * @param source The source of the XML data.
     */
    public void loadMap(InputSource source)
            throws LXMapException, IOException
    {
        try
        {
            XMLReader xr = XMLReaderFactory.createXMLReader("org.apache.xerces.parsers.SAXParser");

            // We require some form of validation on the document
            // as our internal checks are lax
            xr.setFeature("http://xml.org/sax/features/validation", true);

            // Parse and load the map.
            LXSAXHandler handler = new LXSAXHandler();
            xr.setContentHandler(handler);
            xr.setErrorHandler(handler);
            xr.parse(source);

            m_root = handler.getRoot();
            m_nameMap = handler.getNameMap();
            m_nameSet = handler.getNameSet();
        }
        catch(SAXException e)
        {
            Exception inside = e.getException();

            if(inside != null)
            {
                inside.printStackTrace();
                if(inside instanceof LXMapException)
                    throw (LXMapException)inside;
                else if(inside.getMessage() != null)
                    throw new LXMapException(inside.getMessage());
                else
                    throw new LXMapException(inside.getClass().getName());
            }

            throw new LXMapException(e.getMessage());
        }
    }

    /**
     * Load an LX map from a uri.
     *
     * @param uri The fully qualified uri of the file.
     */
    public void loadMap(String uri)
            throws LXMapException, IOException
    {
        loadMap(new InputSource(uri));
    }

    /**
     * Get public (XML) to private (LDAP) name mappings
     * for the first entry.
     *
     * @return The name map.
     */
    public final Map getNameMap()
    {
        return m_nameMap;
    }

    /**
     * Get the minimum set of LDAP attributes required
     * to retrieve items via this map.
     */
    protected final Set getNameSet()
    {
        return m_nameSet;
    }

    public final boolean isLoaded()
    {
        return m_root != null;
    }

    // The root of the LX map
    private LXRoot m_root;

    // Cache of the name map
    private Map m_nameMap;

    // Cache of the name set
    private Set m_nameSet;
}