001    package org.apache.archiva.repository.events;
002    
003    /*
004     * Licensed to the Apache Software Foundation (ASF) under one
005     * or more contributor license agreements.  See the NOTICE file
006     * distributed with this work for additional information
007     * regarding copyright ownership.  The ASF licenses this file
008     * to you under the Apache License, Version 2.0 (the
009     * "License"); you may not use this file except in compliance
010     * with the License.  You may obtain a copy of the License at
011     *
012     *   http://www.apache.org/licenses/LICENSE-2.0
013     *
014     * Unless required by applicable law or agreed to in writing,
015     * software distributed under the License is distributed on an
016     * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
017     * KIND, either express or implied.  See the License for the
018     * specific language governing permissions and limitations
019     * under the License.
020     */
021    
022    import org.apache.archiva.metadata.model.ProjectVersionMetadata;
023    import org.apache.archiva.metadata.repository.MetadataRepository;
024    import org.apache.archiva.metadata.repository.RepositorySession;
025    import org.apache.archiva.metadata.repository.storage.RepositoryStorageMetadataException;
026    
027    /**
028     * Listen to events on the repository. This class is a stopgap
029     * refactoring measure until an event bus is in place to handle
030     * generic events such as these.
031     * <p/>
032     * This assumes that the events occur before the action has completed, though they don't currently offer any mechanism
033     * to prevent an event from occurring or guarantee that it will happen.
034     * <p/>
035     * FIXME: this needs to be made more permanent since 3rd party plugins will depend on it heavily
036     */
037    public interface RepositoryListener
038    {
039        void deleteArtifact( MetadataRepository metadataRepository, String repositoryId, String namespace, String project,
040                             String version, String id );
041    
042        void addArtifact( RepositorySession session, String repoId, String namespace, String projectId,
043                          ProjectVersionMetadata metadata );
044    
045        // FIXME: this would be better as a "processException" method, with the event information captured in a single class
046        void addArtifactProblem( RepositorySession session, String repoId, String namespace, String projectId,
047                                 String projectVersion, RepositoryStorageMetadataException exception );
048    }