001/*
002 *  Copyright 2010 Anyware Services
003 *
004 *  Licensed under the Apache License, Version 2.0 (the "License");
005 *  you may not use this file except in compliance with the License.
006 *  You may obtain a copy of the License at
007 *
008 *      http://www.apache.org/licenses/LICENSE-2.0
009 *
010 *  Unless required by applicable law or agreed to in writing, software
011 *  distributed under the License is distributed on an "AS IS" BASIS,
012 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *  See the License for the specific language governing permissions and
014 *  limitations under the License.
015 */
016package org.ametys.plugins.repository;
017
018/**
019 * {@link TraversableAmetysObject} allowing to create children.
020 */
021public interface ModifiableTraversableAmetysObject extends TraversableAmetysObject, ModifiableAmetysObject
022{
023    /**
024     * Creates a child below current object.
025     * @param <A> the actual type of {@link AmetysObject}.
026     * @param name the name of the child, position (<code>[n]</code>) are not supported for
027     * same name sibling, the child will be added at the end of the children list.
028     * @param type the type of the object.
029     * @return the new object created.
030     * @throws AmetysRepositoryException if an error occurs.
031     * @throws RepositoryIntegrityViolationException if an object with the same name already
032     *         exists and same name siblings is not allowed.
033     */
034    <A extends AmetysObject> A createChild(String name, String type) throws AmetysRepositoryException, RepositoryIntegrityViolationException;
035}