blob: 2c65fb3687c51a19923f378aed151120faf51691 [file] [log] [blame]
//
// 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.
//
= When should I use a WeakListener ?
:page-layout: wikidev
:page-tags: wiki, devfaq, needsreview
:jbake-status: published
:keywords: Apache NetBeans wiki DevFaqWeakListenerWhen
:description: Apache NetBeans wiki DevFaqWeakListenerWhen
:toc: left
:toc-title:
:page-syntax: true
:page-wikidevsection: _development_issues_module_basics_and_classpath_issues_and_information_about_rcpplatform_application_configuration
:page-position: 32
include::front::partial$database.adoc[]
You should use a xref:./DevFaqWeakListener.adoc[WeakListener] any time you are adding a listener to an object, but there is no code - and possibly no opportunity - to explicitly remove it.
If the thing you are listening to does have some kind of observable life-cycle, it is preferable to explicitly add and detach listeners.
But in the case that you are adding a listener which is never explicitly removed, it is good form to use `link:{apidoclink}org-openide-util/org/openide/util/WeakListeners.html[WeakListeners]`