[ https://issues.apache.org/jira/browse/NIFI-391?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16009334#comment-16009334 ]
ASF GitHub Bot commented on NIFI-391: ------------------------------------- Github user trixpan commented on a diff in the pull request: https://github.com/apache/nifi/pull/1718#discussion_r116357827 --- Diff: nifi-api/src/main/java/org/apache/nifi/annotation/documentation/DeprecationNotice.java --- @@ -0,0 +1,51 @@ +/* + * 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.nifi.annotation.documentation; + +import org.apache.nifi.components.ConfigurableComponent; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Inherited; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Annotation that can be applied to a {@link org.apache.nifi.processor.Processor Processor}, + * {@link org.apache.nifi.controller.ControllerService ControllerService}, or + * {@link org.apache.nifi.reporting.ReportingTask ReportingTask} in order to + * warn about the deprecation of the component. The deprecation warning is informational only + * and doesn't affect the processor run time behavior in any way + */ +@Documented +@Target({ElementType.TYPE}) +@Retention(RetentionPolicy.RUNTIME) +@Inherited +public @interface DeprecationNotice { + Class<? extends ConfigurableComponent>[] value() default {}; + + String[] classNames() default {}; + + String reason() default ""; + + + // The following are still not utilised but implemented + // for future use. + String deprecationTargetVersion() default ""; --- End diff -- @mcgilman yeah. happy for you to remove > Need ability to deprecate components > ------------------------------------ > > Key: NIFI-391 > URL: https://issues.apache.org/jira/browse/NIFI-391 > Project: Apache NiFi > Issue Type: New Feature > Components: Core Framework, Core UI, Extensions > Reporter: Mark Payne > Assignee: Andre F de Miranda > > The API should allow processors to be marked as deprecated such that the UI > then shows on the graph that the Processor is deprecated. > Additionally, the UI should show in the Status Bar that there are deprecated > components (processors, reporting tasks, controller services) in the flow. > This valuable because of improvements such as NIFI-377. In this case, we have > a community member making the Base64EncodeContent processor more generic so > that it can encode/decode base 16,32, and 64. At this point, > Base64EncodeContent doesn't make sense as a name, so there is a more generic > EncodeContent processor. We don't need both, so we want to deprecated the > Base64EncodeContent processor. -- This message was sent by Atlassian JIRA (v6.3.15#6346)