Java URI to Parent URI getParent(final URI uri)

Description

Returns the parent of the specified URI.

License

Apache License

Parameter

Parameter	Description
uri	The URI for which to return the parent.

Exception

Parameter	Description
IllegalArgumentException	<ul> <li>The URI cannot be null></li> <li>Can't resolve parent for the specifiedURI.</li> </ul>

Return

The parent of the specified URI.

Declaration

public static URI getParent(final URI uri) throws IllegalArgumentException 

Method Source Code

//package com.java2s;
/*/*from w ww  .j a va2s . c  o m*/
   Copyright 2009 Tomer Gabel <tomer@tomergabel.com>
    
   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.
    
    
   ant-intellij-tasks project (http://code.google.com/p/ant-intellij-tasks/)
    
   $Id$
*/

import java.net.URI;
import java.net.URISyntaxException;

public class Main {
    /**
     * A static URI which, when resolved against another URI, returns the other URI's parent.
     */
    private static final URI up = URI.create("..");

    /**
     * Returns the parent of the specified URI.
     * <p/>
     * For example, applying this method to the URI &quot;<tt>http://www.site.com/articles/article.html</tt>&quot; will
     * return the URI for &quot;<tt>http://www.site.com/articles/</tt>&quot;.
     *
     * @param uri The URI for which to return the parent.
     * @return The parent of the specified URI.
     * @throws IllegalArgumentException <ul> <li>The URI cannot be null></li> <li>Can't resolve parent for the specified
     *                                  URI.</li> </ul>
     */
    public static URI getParent(final URI uri) throws IllegalArgumentException {
        if (uri == null)
            throw new IllegalArgumentException("The URI cannot be null.");

        final String path = uri.toString();
        final int finalSeparator = Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\'));
        final int extension = path.lastIndexOf('.');
        if (extension > finalSeparator)
            try {
                // Extract all but final segment
                return new URI(path.substring(0, finalSeparator + 1)).normalize();
            } catch (URISyntaxException e) {
                throw new IllegalArgumentException("Can't resolve parent for the specified URI.", e);
            }
        else
            return uri.resolve(up);
    }
}

Related

1. getParams(URI uri)
2. getParent(URI path)
3. getParent(URI uri)
4. getParentName(URI uri)
5. getParents(final URI uri)