matthiasblaesing commented on a change in pull request #3209: URL: https://github.com/apache/netbeans/pull/3209#discussion_r734983195
########## File path: ide/parsing.indexing/src/org/netbeans/modules/parsing/spi/indexing/IndexabilityQueryImplementation.java ########## @@ -0,0 +1,82 @@ +/* + * 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.netbeans.modules.parsing.spi.indexing; + +import java.net.URL; +import javax.swing.event.ChangeListener; +import org.openide.filesystems.FileObject; + +/** + * Determine whether files should be skipped for indexing. + * <p> + * Global lookup is used to find all instances of + * IndexabilityQueryImplementation. + * </p> + * <p> + * Threading note: implementors should avoid acquiring locks that might be held + * by other threads. Generally treat this interface similarly to SPIs in + * {@link org.openide.filesystems} with respect to threading semantics. + * </p> + * + * @see org.netbeans.api.queries.IndexabilityQuery + * @since org.netbeans.modules.parsing.indexing 9.22.0 + */ +public interface IndexabilityQueryImplementation { + + /** + * Determine if the supplied file object should be indexed. + * + * @param fo file object to be indexed + * @return true if indexing should be prevented + */ + default boolean preventIndexing(FileObject fo) { + return false; + } + + /** + * Determine if the supplied indexable should be indexed using the given + * indexer (identified either by the name of the indexer or its factory + * class). + * + * @param indexerName name of the indexer that will be invoked on the + * indexable + * @param factoryClassName class name of the factory for the indexer that + * will be invoked on the indexable + * @param indexable the file that is about to be indexed + * @param rootUrl the root of the index process, can be {@code null} + * @return + */ + default boolean preventIndexing(String indexerName, String factoryClassName, URL indexable, URL rootUrl) { Review comment: I removed the class name from the api - the indexer name should be enough to decide whether or not an indexer should be blocked. Leaking the implementation detail should only be a last resort, but currently it is not needed. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected] For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
