org.apache.cayenne.map.PathComponentIterator Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cayenne-client
An aggregation of 1.4, 1.5 modules into an ROP client jar.
There is a newer version: 4.2.1
/*****************************************************************
 *   Licensed to the Apache Software Foundation (ASF) under one
 *  or more contributor license agreements.  See the NOTICE file
 *  distributed with this work for additional information
 *  regarding copyright ownership.  The ASF licenses this file
 *  to you 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 org.apache.cayenne.map;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.Iterator;
import java.util.Map;
import java.util.StringTokenizer;

import org.apache.cayenne.exp.ExpressionException;

/**
 * @since 3.0
 */
class PathComponentIterator implements Iterator> {

    private StringTokenizer toks;
    private Entity currentEntity;
    private String path;
    private Map aliasMap;

    PathComponentIterator(Entity root, String path, Map aliasMap) {
        currentEntity = root;
        toks = new StringTokenizer(path, Entity.PATH_SEPARATOR);
        this.path = path;
        this.aliasMap = aliasMap;
    }

    public boolean hasNext() {
        return toks.hasMoreTokens();
    }

    public PathComponent next() {
        String pathComp = toks.nextToken();

        JoinType relationshipJoinType = JoinType.INNER;

        // we only support LEFT JOINS for now...
        if (pathComp.endsWith(Entity.OUTER_JOIN_INDICATOR)) {
            relationshipJoinType = JoinType.LEFT_OUTER;
            pathComp = pathComp.substring(0, pathComp.length()
                    - Entity.OUTER_JOIN_INDICATOR.length());
        }

        // see if this is an attribute
        Attribute attr = currentEntity.getAttribute(pathComp);
        if (attr != null) {
            // do a sanity check...
            if (toks.hasMoreTokens())
                throw new ExpressionException(
                        "Attribute must be the last component of the path: '"
                                + pathComp
                                + "'.",
                        path,
                        null);

            return new AttributePathComponent(attr);
        }

        Relationship rel = currentEntity.getRelationship(pathComp);
        if (rel != null) {
            currentEntity = rel.getTargetEntity();
            return new RelationshipPathComponent(
                    rel,
                    relationshipJoinType,
                    !hasNext());
        }

        String aliasedPath = (aliasMap != null) ? aliasMap.get(pathComp) : null;
        if (aliasedPath != null) {

            // a few fairly arbitrary assumptions.... if we find that they restrict valid
            // and useful cases, we can change this behavior:
            // 
            // 1. No nested aliases. Aliased path must contain only unaliased component
            // names.
            // 2. Subpath must be relationship-only. Aliasing attributes doesn't seem
            // useful, so we don't handle this case for simplicity...

            // fully resolve subpath here... since we need to know the target entity of
            // the subpath, we have to fully traverse it, hence instead of lazy iterator
            // we might as well reuse obtained information in the AliasPathComponent

            Iterator> subpathIt = new PathComponentIterator(
                    currentEntity,
                    aliasedPath,
                    Collections.EMPTY_MAP);

            Collection> parsedSubpath = new ArrayList>(
                    4);

            while (subpathIt.hasNext()) {
                PathComponent subpathComponent = subpathIt
                        .next();

                Relationship subpathRelationship = subpathComponent.getRelationship();
                if (subpathRelationship == null) {
                    throw invalidPathException(
                            "Expected a relationship in the aliased subpath. Alias ["
                                    + pathComp
                                    + "]",
                            subpathComponent.getName());
                }

                currentEntity = subpathRelationship.getTargetEntity();
                parsedSubpath.add(subpathComponent);
            }

            return new AliasPathComponent(
                    pathComp,
                    parsedSubpath,
                    !hasNext());
        }

        throw invalidPathException("Can't resolve path component", pathComp);
    }

    private ExpressionException invalidPathException(String message, String pathComponent) {
        StringBuilder buffer = new StringBuilder();
        buffer
                .append(message)
                .append(": [")
                .append(currentEntity.getName())
                .append('.')
                .append(pathComponent)
                .append("].");
        return new ExpressionException(buffer.toString(), path, null);
    }

    public void remove() {
        throw new UnsupportedOperationException("'remove' operation is not supported.");
    }
}