/* * ################################################################ * * FenixEdu: The Java(TM) Object-Oriented Framework for University * Academic Applications * * Copyright (C) 2002-2003 IST/Technical University of Lisbon * Contact: suporte@dot.ist.utl.pt * * This library 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.1 of the License, or any later version. * * This library 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 library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * USA * * Initial developer(s): The Fenix Team * http://fenix-ashes.ist.utl.pt/ * * Contributor(s): José Pedro Pereira - Educare S.A. - http://www.linkare.com * * ################################################################ */ package net.sourceforge.fenixedu.presentationTier.servlets; import java.io.IOException; import java.io.PrintWriter; import java.lang.reflect.Method; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.Comparator; import java.util.HashMap; import java.util.Iterator; import java.util.List; import javax.servlet.ServletConfig; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import net.sourceforge.fenixedu._development.MetadataManager; import net.sourceforge.fenixedu.domain.DomainObject; import net.sourceforge.fenixedu.domain.RootDomainObject; import net.sourceforge.fenixedu.persistenceTier.OJB.SuportePersistenteOJB; import org.apache.ojb.broker.core.proxy.ProxyHelper; import dml.DomainClass; import dml.DomainEntity; import dml.DomainModel; import dml.Role; import dml.Slot; public class DomainBrowserServlet extends HttpServlet { private static DomainModel domainModel; private static HashMap domainClassesDescAttr = new HashMap(); public void init(ServletConfig config) throws ServletException { super.init(config); try { domainModel = MetadataManager.getDomainModel(); } catch (Exception e) { domainModel = null; } } public void doGet(HttpServletRequest req, HttpServletResponse res) throws ServletException, IOException { res.setContentType("text/html"); PrintWriter out = res.getWriter(); out.println("Fenix Domain Browser\n"); String path = req.getPathInfo(); try { if ("/listAll".equals(path)) { renderListAll(out, RequestParams.parse(req, "domainClass")); } else if ("/showObj".equals(path)) { renderDomainObject(out, RequestParams.parse(req, "domainClass", "objId")); } else if ("/listRole".equals(path)) { renderDomainObjectRole(out, RequestParams.parse(req, "domainClass", "objId", "role")); } else if ("/checkDomain".equals(path)) { checkDomain(out); } else { renderMainIndex(out); } } catch (Exception e) { e.printStackTrace(); throw new Error("Error: " + e.getMessage()); } out.println("\n"); out.close(); } protected void renderDomainObject(PrintWriter out, RequestParams params) throws IOException,Exception { if (params == null) { renderMainIndex(out); return; } SuportePersistenteOJB supPers = SuportePersistenteOJB.getInstance(); try { supPers.beginTransaction(); DomainObject domObj = getDomainObject(supPers.getIPersistentObject().readByOID(params.javaClass, params.oid)); if (domObj == null) { out.println("

No such object

"); return; } out.println("

"); out.println(params.classFullName); out.println(" Instance: "); out.println(getObjectDescription(domObj, params.domClass)); out.println("

\n"); out.println("

Attributes

\n"); out.println("\n"); for (String attr : getAllAttrs(params.domClass)) { out.println(""); } out.println("

"); out.println(attr); out.println("

"); out.println(getAttributeValue(domObj, attr)); out.println("

\n"); out.println("

Relations

"); out.println("\n"); for (Role role : getAllRoles(params.domClass)) { out.println(""); } out.println("

"); out.println(role.getName()); out.println("

"); Object roleValue = getAttributeValue(domObj, role.getName()); if (role.getMultiplicityUpper() == 1) { if (roleValue == null) { out.println("null"); } else { DomainEntity roleType = role.getType(); if (roleType instanceof DomainClass) { renderObjectId(out, getDomainObject(roleValue), (DomainClass)roleType); } else { out.println(roleValue); } } } else { if (roleValue == null) { out.println("null collection"); } else { Collection col = (Collection)roleValue; int colSize = -1; try { colSize = col.size(); } catch (Exception e) { // ignore it } if (colSize == -1) { out.println("THIS IS NULL: missing from OJB mapping?"); } else { out.println(""); out.println(role.getType().getFullName()); out.println("["); out.println(colSize); out.println("]"); } } } out.println("

\n"); } finally { supPers.abortTransaction(); } } protected void renderDomainObjectRole(PrintWriter out, RequestParams params) throws IOException,Exception { if (params == null) { renderMainIndex(out); return; } SuportePersistenteOJB supPers = SuportePersistenteOJB.getInstance(); try { supPers.beginTransaction(); DomainObject domObj = getDomainObject(supPers.getIPersistentObject().readByOID(params.javaClass, params.oid)); if (domObj == null) { out.println("

No such object

"); return; } out.println("

"); renderObjectId(out, domObj, params.domClass); out.println("'s "); out.println(params.roleName); out.println(":

\n"); Collection insts = (Collection)getAttributeValue(domObj, params.roleName); renderCollection(out, insts, (DomainClass)params.role.getType(), params); } finally { supPers.abortTransaction(); } } protected void renderListAll(PrintWriter out, RequestParams params) throws IOException,Exception { if (params == null) { renderMainIndex(out); return; } out.println("

"); out.println(params.classFullName); out.println(" Entities

\n"); SuportePersistenteOJB supPers = SuportePersistenteOJB.getInstance(); try { supPers.beginTransaction(); Collection insts = RootDomainObject.readAllDomainObjects(params.javaClass); renderCollection(out, insts, params.domClass, params); } finally { supPers.abortTransaction(); } } protected void renderCollection(PrintWriter out, Collection insts, DomainClass domClass, RequestParams params) throws IOException,Exception { if (insts == null) { out.println("

Null collection

"); return; } int total = insts.size(); int first = params.start; int last = Math.min(first + params.max - 1, total); out.println("

Total instances: "); out.println(total); out.println("

\n"); if ((total > last) || (first > 1)) { out.println("

Showing from "); out.println(first); out.println(" to "); out.println(last); out.println("

\n"); } if (first > total) { return; } if (last < total) { params.start = last + 1; out.println("

Show next

"); params.start = first; } out.println("

"); renderObjectId(out, getDomainObject(iter.next()), domClass); out.println("

\n"); } protected void renderObjectId(PrintWriter out, DomainObject domObj, DomainClass domClass) throws IOException { out.println(""); out.println(getObjectDescription(domObj, domClass)); out.println(""); } protected String getObjectDescription(DomainObject domObj, DomainClass domClass) { String description = getSpecializedDescription(domObj); if (description == null) { String descAttribute = getDescAttribute(domClass); description = getAttributeValue(domObj, descAttribute).toString(); } return description; } protected String getDescAttribute(DomainClass domClass) { String descAttribute = domainClassesDescAttr.get(domClass); if (descAttribute == null) { descAttribute = guessDescAttribute(domClass); domainClassesDescAttr.put(domClass, descAttribute); } return descAttribute; } protected String guessDescAttribute(DomainClass domClass) { String descAttr = "idInternal"; for (String attr : getAllAttrs(domClass)) { if (attr.equals("name") || attr.equals("nome")) { descAttr = attr; break; } } return descAttr; } protected Object getAttributeValue(Object obj, String attr) { try { Method reader = obj.getClass().getMethod("get" + capitalize(attr)); return reader.invoke(obj); } catch (Exception e) { return null; } } protected void renderMainIndex(PrintWriter out) throws IOException { out.println("

All Entities

\n"); if (domainModel != null) { out.println("

UML "); out.println(domClass.getName()); out.println("

\n"); } else { out.println("

There are none...

\n"); } } protected void checkDomain(PrintWriter out) throws Exception { out.println("

Domain Check

\n"); if (domainModel != null) { SuportePersistenteOJB supPers = SuportePersistenteOJB.getInstance(); for (DomainClass domClass : getAllDomainClasses()) { System.out.println("CHECK DOMAIN: checking " + domClass.getFullName()); List roles = getAllRoles(domClass); if (! roles.isEmpty()) { try { supPers.beginTransaction(); Collection insts = RootDomainObject.readAllDomainObjects(Class.forName(domClass.getFullName())); if (insts.size() == 0) { out.print("

Can't check "); out.print(domClass.getFullName()); out.println(": there are no instances!

"); } else { for (Role role : roles) { String header = "

Checking role " + role.getName() + " for class " + domClass.getFullName() + "

Summary: "); out.print(insts.size()); out.print("total objects, "); out.print(objsWithRoleNonEmpty); out.print(" relations checked, "); out.print(objsWithInverseOK); out.println(" relations with inverse OK

"); } } } } finally { supPers.abortTransaction(); } } } } else { out.println("

There are none...

\n"); } } protected void renderWrongRelation(PrintWriter out, DomainObject obj, Role role, DomainClass domClass) throws Exception { System.out.println("wrong relation"); out.println("

"); renderObjectId(out, obj, domClass); out.println("

\n"); } private boolean checkInverseRelation(DomainObject source, DomainObject target, Role role) { Role inverseRole = null; for (Role otherRole : (List)role.getRelation().getRoles()) { if (otherRole != role) { inverseRole = otherRole; break; } } Object inverseRoleValue = getAttributeValue(target, inverseRole.getName()); if (inverseRole.getMultiplicityUpper() == 1) { return (source == getDomainObject(inverseRoleValue)); } else { return ((Collection)inverseRoleValue).contains(source); } } private static HashMap> domainClassesAttributes = new HashMap>(); protected synchronized List getAllAttrs(DomainClass domClass) { List attrs = domainClassesAttributes.get(domClass); if (attrs == null) { attrs = new ArrayList(); DomainEntity domEntity = domClass; while (domEntity instanceof DomainClass) { DomainClass dClass = (DomainClass)domEntity; Iterator slots = dClass.getSlots(); while (slots.hasNext()) { attrs.add(((Slot)slots.next()).getName()); } domEntity = dClass.getSuperclass(); } Collections.sort(attrs); domainClassesAttributes.put(domClass, attrs); } return attrs; } private static HashMap> domainClassesRoles = new HashMap>(); private static final Comparator ROLE_COMPARATOR = new Comparator() { public int compare(Role r1, Role r2) { return r1.getName().compareTo(r2.getName()); } }; protected List getAllRoles(DomainClass domClass) { List roles = domainClassesRoles.get(domClass); if (roles == null) { roles = new ArrayList(); DomainEntity domEntity = domClass; while (domEntity instanceof DomainClass) { DomainClass dClass = (DomainClass)domEntity; Iterator roleSlots = dClass.getRoleSlots(); while (roleSlots.hasNext()) { Role role = (Role)roleSlots.next(); if (role.getName() != null) { roles.add(role); } } domEntity = dClass.getSuperclass(); } Collections.sort(roles, ROLE_COMPARATOR); domainClassesRoles.put(domClass, roles); } return roles; } private static List allDomainClasses = null; protected List getAllDomainClasses() { if (allDomainClasses == null) { allDomainClasses = new ArrayList(); for (Iterator iter = domainModel.getClasses(); iter.hasNext();) { allDomainClasses.add((DomainClass)iter.next()); } Collections.sort(allDomainClasses, new Comparator() { public int compare(DomainClass dc1, DomainClass dc2) { return dc1.getName().compareTo(dc2.getName()); } }); } return allDomainClasses; } protected String capitalize(String str) { if ((str == null) || Character.isUpperCase(str.charAt(0))) { return str; } else { return Character.toUpperCase(str.charAt(0)) + str.substring(1); } } protected DomainObject getDomainObject(Object obj) { return (DomainObject)ProxyHelper.getRealObject(obj); } static class RequestParams { private static final String[] OPTIONAL_PARAMS = { "start", "max" }; public static final int DEFAULT_MAX = 100; String path; String classFullName = null; DomainClass domClass = null; Class javaClass = null; int oid = -1; String roleName = null; Role role = null; int start = 1; int max = DEFAULT_MAX; String buildURL() { StringBuilder sb = new StringBuilder(); sb.append(path); String sep = "?"; if (classFullName != null) { sb.append(sep); sb.append("domainClass="); sb.append(classFullName); sep = "&"; } if (oid != -1) { sb.append(sep); sb.append("objId="); sb.append(oid); sep = "&"; } if (roleName != null) { sb.append(sep); sb.append("role="); sb.append(roleName); sep = "&"; } if (start > 1) { sb.append(sep); sb.append("start="); sb.append(start); sep = "&"; } if (max != DEFAULT_MAX) { sb.append(sep); sb.append("max="); sb.append(max); sep = "&"; } return sb.toString(); } static RequestParams parse(HttpServletRequest req, String... paramNames) { RequestParams params = new RequestParams(); params.path = req.getPathInfo().substring(1); try { for (String name : paramNames) { String value = req.getParameter(name); if (value == null) { return null; } if (name.equals("domainClass")) { params.classFullName = value; params.javaClass = Class.forName(value); params.domClass = domainModel.findClass(value); if (params.domClass == null) { return null; } } else if (name.equals("objId")) { params.oid = Integer.parseInt(value); } else if (name.equals("role")) { params.roleName = value; params.role = params.domClass.findRoleSlot(value); if (params.role == null) { return null; } } else { return null; } } } catch (Exception e) { return null; } // parse optional parameters for (String name : OPTIONAL_PARAMS) { String value = req.getParameter(name); if (value != null) { try { if (name.equals("start")) { params.start = Integer.parseInt(value); } else if (name.equals("max")) { params.max = Integer.parseInt(value); } } catch (Exception e) { // ignore it } } } return params; } } static class SpecializedMethod { Method method = null; } private static HashMap specializedMethods = new HashMap(); protected static String getSpecializedDescription(Object obj) { Method m = findSpecializedMethod(obj.getClass()); if (m != null) { try { return (String)m.invoke(null, obj); } catch (Exception e) { // ignore errors on the method } } return null; } protected synchronized static Method findSpecializedMethod(Class objClass) { SpecializedMethod sm = specializedMethods.get(objClass); if (sm == null) { sm = new SpecializedMethod(); specializedMethods.put(objClass, sm); while (objClass != null) { try { Method m = DomainObjectsExternalDescriptions.class.getMethod("getShortDescription", objClass); sm.method = m; // finish the loop because we found it already... break; } catch (Exception e) { // not found the method, so continue the loop } objClass = objClass.getSuperclass(); } } return sm.method; } }