com.globalmentor.swing.rdf.tree.RDFTreeUtilities Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of globalmentor-swing Show documentation
GlobalMentor Java Swing library.
The newest version!
/*
 * Copyright © 1996-2009 GlobalMentor, Inc. 
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.globalmentor.swing.rdf.tree;

import java.util.*;
import javax.swing.tree.*;

import com.globalmentor.net.Resource;
import com.globalmentor.rdf.*;

/**
 * Utilities for manipulating trees of RDF resources.
 * @author Garret Wilson
 * @see FilePropertiesConstants
 */
public class RDFTreeUtilities {

	/**
	 * Creates a tree node that recognizes resources representing a folder structure.
	 * @param rdf The RDF data model.
	 * @param topLevelResourceList The list of resources, each a Resource, that each indicate the URI of a parent resource to appear under the root.
	 * @return A single tree node under which resoure nodes have been created to represent a file structure.
	 * @see Resource#getReferenceURI
	 * @see FilePropertiesConstants
	 */
	public static MutableTreeNode createFileResourceTreeNode(final RDFModel rdf, final List topLevelResourceList) {
		final DefaultMutableTreeNode rootNode = new DefaultMutableTreeNode("Resources"); //create the root node TODO i18n; fix
		//create the top-level resources
		final Iterator topLevelResourceIterator = topLevelResourceList.iterator(); //get an iterator to all the top-level resources
		while(topLevelResourceIterator.hasNext()) { //while there are more top-level resources
			final Resource topLevelResource = topLevelResourceIterator.next(); //get the next top-level resource
			final RDFResource topLevelRDFResource = rdf.getResource(topLevelResource.getURI()); //get the RDF resource representing the top-level resource
			if(topLevelRDFResource != null) { //if such an RDF resource exists TODO fix error handling
				final RDFResourceTreeNode topLevelTreeNode = createFileResourceTreeNode(topLevelRDFResource); //create a tree node from the top-level resource
				rootNode.add(topLevelTreeNode); //add the tree node to the root
			}
		}
		return rootNode; //return the root node we constructed
	}

	/**
	 * Creates a tree node to represent an RDF resource. If the resource is a folder resource that has child resources in an XPackage manifest, child resources
	 * are recursively created for those child resource.
	 * @param rdfResource The resource for which a tree node should be created.
	 * @return A tree node for the given resource.
	 */
	public static RDFResourceTreeNode createFileResourceTreeNode(final RDFResource rdfResource) {
		final RDFResourceTreeNode rdfResourceTreeNode = new RDFResourceTreeNode(rdfResource); //create a new tree node to represent the RDF resource
		//if this is a folder TODO see if we should allow navigation of normal nodes with children
		/*TODO fix with URF
				if(Marmot.isCollection(rdfResource))
				{


		//TODO move this whole class to RDFTree and give that class options for showing properties and/or manifest items 
					final RDFListResource manifest=Marmot.getContents(rdfResource); //get the resource manifest
					if(manifest!=null) {	//if the resource has a manifest
							//get the resources in this folder
						final Iterator itemResourceIterator=manifest.iterator();  //get an iterator to all the contained resources
						while(itemResourceIterator.hasNext()) {	//while there are more resources
							final RDFResource itemResource=(RDFResource)itemResourceIterator.next();  //get the next resource
		Log.trace("found item resource: ", itemResource);  //TODO del
								//create a new tree node to represent the resource, recursively discovering folders
							final RDFResourceTreeNode itemResourceNode=createFileResourceTreeNode(itemResource);
							rdfResourceTreeNode.add(itemResourceNode); //add the resource node to the folder node
						}
					}
				}
		*/
		return rdfResourceTreeNode; //return the tree node for the resource
	}

}