tracesrv/tracecompiler/src/com.nokia.tracecompiler/src/com/nokia/tracecompiler/source/SourceLocation.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/tracesrv/tracecompiler/src/com.nokia.tracecompiler/src/com/nokia/tracecompiler/source/SourceLocation.java Fri Oct 08 14:56:39 2010 +0300
@@ -0,0 +1,184 @@
+/*
+* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+* Represents a location in source
+*
+*/
+package com.nokia.tracecompiler.source;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Iterator;
+import java.util.List;
+
+/**
+ * Represents a location in source
+ *
+ */
+public class SourceLocation extends SourceLocationBase {
+
+ /**
+ * Location listeners
+ */
+ private ArrayList<SourceLocationListener> locationListeners;
+
+ /**
+ * Temporary array for callback purposes. Prevents concurrent modifications
+ * if listeners are removed during a callback
+ */
+ private ArrayList<SourceLocationListener> tempListeners;
+
+ /**
+ * Reference count
+ */
+ private int refCount = 0;
+
+ /**
+ * Listener change flag
+ */
+ private boolean listenersChanged = true;
+
+ /**
+ * Constructor
+ *
+ * @param parser
+ * the parser owning this location
+ * @param offset
+ * offset of location
+ * @param length
+ * length of location
+ */
+ public SourceLocation(SourceParser parser, int offset, int length) {
+ super(parser, offset, length);
+ parser.addLocation(this);
+ refCount = 1;
+ }
+
+ /**
+ * Gets the name of the class which owns this location
+ *
+ * @return the class name
+ */
+ public String getClassName() {
+ String retval = null;
+ if (getParser() != null) {
+ SourceContext context = getParser().getContext(getOffset());
+ if (context != null) {
+ retval = context.getClassName();
+ }
+ }
+ return retval;
+ }
+
+ /**
+ * Gets the name of function which owns this location
+ *
+ * @return the function name
+ */
+ public String getFunctionName() {
+ String retval = null;
+ if (getParser() != null) {
+ SourceContext context = getParser().getContext(getOffset());
+ if (context != null) {
+ retval = context.getFunctionName();
+ }
+ }
+ return retval;
+ }
+
+ /**
+ * Adds a location listener to this location
+ *
+ * @param listener
+ * the location listener
+ */
+ public void addLocationListener(SourceLocationListener listener) {
+ if (locationListeners == null) {
+ locationListeners = new ArrayList<SourceLocationListener>();
+ }
+ locationListeners.add(listener);
+ listenersChanged = true;
+ }
+
+ /**
+ * Removes a location listener from this location
+ *
+ * @param listener
+ * the location listener
+ */
+ public void removeLocationListener(SourceLocationListener listener) {
+ if (locationListeners != null) {
+ if (locationListeners.remove(listener)) {
+ listenersChanged = true;
+ }
+ }
+ }
+
+ /**
+ * Gets the listener interfaces
+ *
+ * @return the listeners
+ */
+ protected Iterator<SourceLocationListener> getListeners() {
+ List<SourceLocationListener> list;
+ if (locationListeners != null) {
+ if (listenersChanged) {
+ listenersChanged = false;
+ if (tempListeners == null) {
+ tempListeners = new ArrayList<SourceLocationListener>();
+ }
+ tempListeners.clear();
+ tempListeners.addAll(locationListeners);
+ }
+ list = tempListeners;
+ } else {
+ list = Collections.emptyList();
+ }
+ return list.iterator();
+ }
+
+ /**
+ * Increases the reference count of this location.
+ *
+ * @see #dereference()
+ */
+ public void reference() {
+ refCount++;
+ }
+
+ /**
+ * Decrements the reference count of this location. When reference count is
+ * 0, this is removed from source. Note that a location can also be removed
+ * from source even if it has outstanding references left. In that case it
+ * can no longer be selected.
+ */
+ public void dereference() {
+ if (--refCount <= 0) {
+ removeFromSource();
+ }
+ }
+
+ /**
+ * Removes this location from the source
+ */
+ private void removeFromSource() {
+ delete();
+ if (getParser() != null) {
+ getParser().removeLocation(this);
+ resetParser();
+ }
+ }
+
+}