/*
* eXist Open Source Native XML Database
* Copyright (C) 2004-2009 The eXist Project
* http://exist-db.org
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, write to the Free Software Foundation
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
* $Id$
*/
package org.exist.xquery.functions.xmldb;
import org.apache.log4j.Logger;
import org.exist.dom.QName;
import org.exist.security.User;
import org.exist.xmldb.LocalCollection;
import org.exist.xmldb.UserManagementService;
import org.exist.xmldb.XmldbURI;
import org.exist.xquery.BasicFunction;
import org.exist.xquery.Cardinality;
import org.exist.xquery.FunctionSignature;
import org.exist.xquery.XPathException;
import org.exist.xquery.XQueryContext;
import org.exist.xquery.value.AnyURIValue;
import org.exist.xquery.value.BooleanValue;
import org.exist.xquery.value.FunctionReturnSequenceType;
import org.exist.xquery.value.FunctionParameterSequenceType;
import org.exist.xquery.value.Sequence;
import org.exist.xquery.value.SequenceType;
import org.exist.xquery.value.StringValue;
import org.exist.xquery.value.Type;
import org.exist.xquery.value.ValueSequence;
import org.xmldb.api.base.Collection;
import org.xmldb.api.base.XMLDBException;
/**
* Various functions to get information about users.
* /**
* @author Wolfgang Meier (wolfgang@exist-db.org)
* @author Luigi P. Bai, finder@users.sf.net, 2004
*
*/
public class XMLDBUserAccess extends BasicFunction {
protected static final FunctionParameterSequenceType ARG_USER_ID = new FunctionParameterSequenceType("user-id", Type.STRING, Cardinality.EXACTLY_ONE, "The user-id");
protected static final Logger logger = Logger.getLogger(XMLDBUserAccess.class);
public final static FunctionSignature fnExistsUser = new FunctionSignature(
new QName("exists-user", XMLDBModule.NAMESPACE_URI, XMLDBModule.PREFIX),
"Returns true if the user $user-id exists.",
new SequenceType[]{ ARG_USER_ID },
new FunctionReturnSequenceType(Type.BOOLEAN, Cardinality.EXACTLY_ONE, "true() if the user exists, false() otherwise"));
public final static FunctionSignature fnUserGroups = new FunctionSignature(
new QName("get-user-groups", XMLDBModule.NAMESPACE_URI, XMLDBModule.PREFIX),
"Returns the sequence of groups the user $user-id is a member of.",
new SequenceType[]{ ARG_USER_ID },
new FunctionReturnSequenceType(Type.STRING, Cardinality.ONE_OR_MORE, "the group memberships"));
//TODO: let users know about signature change from string to any_uri
public final static FunctionSignature fnUserHome = new FunctionSignature(
new QName("get-user-home", XMLDBModule.NAMESPACE_URI, XMLDBModule.PREFIX),
"Returns the user's home collection URI or the empty sequence " +
"if no home collection is assigned to the user $user-id.",
new SequenceType[]{ ARG_USER_ID },
new FunctionReturnSequenceType(Type.ANY_URI, Cardinality.ZERO_OR_ONE, "the home collection URI of user $user-id if one is assigned, otherwise the empty sequence"));
/**
* @param context
* @param signature
*/
public XMLDBUserAccess(XQueryContext context, FunctionSignature signature) {
super(context, signature);
}
/*
* (non-Javadoc)
*
* @see org.exist.xquery.Expression#eval(org.exist.dom.DocumentSet,
* org.exist.xquery.value.Sequence, org.exist.xquery.value.Item)
*/
public Sequence eval(Sequence args[], Sequence contextSequence)
throws XPathException {
String userName = args[0].getStringValue();
Collection collection = null;
try {
collection = new LocalCollection(context.getUser(), context.getBroker().getBrokerPool(), XmldbURI.ROOT_COLLECTION_URI, context.getAccessContext());
UserManagementService ums = (UserManagementService) collection.getService("UserManagementService", "1.0");
User user = ums.getUser(userName);
if(isCalledAs("exists-user"))
return null == user ? BooleanValue.FALSE : BooleanValue.TRUE;
if(user == null) {
logger.error("User not found: " + userName);
throw new XPathException(this, "User not found: " + userName);
}
if(isCalledAs("get-user-groups")) {
ValueSequence groups = new ValueSequence();
String[] gl = user.getGroups();
for (int i = 0; i < gl.length; i++) {
groups.add(new StringValue(gl[i]));
}
return groups;
// get-user-home
} else {
XmldbURI home = user.getHome();
return null == home ? Sequence.EMPTY_SEQUENCE : new AnyURIValue(home);
}
} catch (XMLDBException e) {
logger.error(e.getMessage());
throw new XPathException(this, "Failed to query user " + userName, e);
} finally {
if (null != collection)
try { collection.close(); } catch (XMLDBException e) { /* ignore */ }
}
}
}