Clean up the utility classes and methods

[AaronGreenhouse]

I searched through for classes in the workspace that contain Util in the name. I came up with this list after filtering out some classes that were obviously related to supported Xtext or some other framework:

• org.osate.aadl2.instance.util.InstanceUtil
• org.osate.aadl2.parsesupport.ParseUtil
• org.osate.aadl2.util.Aadl2InstanceUtil
• org.osate.aadl2.util.Aadl2Util
• org.osate.aadl2.modelsupport.resources.OsateResourceUtil
• org.osate.aadl2.modelsupport.scoping.Aadl2GlobalScopeUtil
• org.osate.aadl2.modelsupport.util.AadlUtil
• org.osate.aadl2.modelsupport.util.ResolvePrototypeUtil
• org.osate.analysis.flows.FlowLatencyUtil
• org.osate.analysis.flows.reporting.utils.ReportUtils
• org.osate.annexsupport.AnnexParseUtil
• org.osate.annexsupport.AnnexUtil
• org.osate.importer.Utils
• org.osate.importer.simulink.Utils
• org.osate.importer.simulink.generator.Utils
• org.osate.pluginsupport.ExecuteJavaUtil
• org.osate.pluginsupport.PluginSupportUtil
• org.osate.result.util.ResultUtil
• org.osate.ge.internal.ui.util.UiUtil
• org.osate.ui.UiUtil
• org.osate.ui.utils.FileUtils
• org.osate.utils.Aadl2Utils
• org.osate.utils.Aadl2Visitors
• org.osate.utils.FileUtils
• org.osate.utils.FloatUtil
• org.osate.utils.FloatRange
• org.osate.utils.IntegerRange
• org.osate.utils.PropertyUtils
• org.osate.utils.UnitConversion
• org.osate.verify.util.VerifyJavaUtil
• org.osate.verify.util.VerifyUtilExtension
• org.osate.xtext.aadl2.properties.util.InstanceModelUtil
• org.osate.xtext.aadl2.properties.util.PropertyUtils

These classes need to be inspected, consolidated, and @deprecated.

Some work has already been one on OsateResourceUtil. I think this was previously deprecated and if so, should be able to be removed immediately.

Most of the property-related stuff I think is being replaced by issue #2113.

Some of this following

• org.osate.annexsupport.AnnexParseUtil
• org.osate.annexsupport.AnnexUtil
• org.osate.pluginsupport.ExecuteJavaUtil
• org.osate.pluginsupport.PluginSupportUtil

is related to supporting stand-alone "headless" Eclipse execution, that should have it's own issue.

[AaronGreenhouse]

org.osate.analysis.flows.FlowLatencyUtil should be made non public by making it an internal package.

[AaronGreenhouse]

Looking at package org.osate.utils. The whole thing seems questionable, although there are some users of it.

• Unused: FloatRange and IntegerRange, PropertyNotFound (a Runtime exception)
• UnitConversion has only one method convertInMs(). That method is only called by PropertyUtils.getFloatValue(NamedElement, String, String), which itself doesn't seem to be used by anyone. It's a questionable use of convertInMs because it is not guaranteed to be dealing with time units.
• FloatUtil is only used by UnitConversion
• FileUtils is only used by AadlBaExamplesWizard (the copy files method). But this whole class seems unnecessary because it doesn't use the Eclipse Resource API, rather it used java.io. AadlBaExamplesWizard should be changed to use the correct eclipse API.
• PropertyUtils is only used in the org.osate.ba project. Seems obsolete, especially given Joe's work on a property getter code generator.

Oh, I see. I this project/project is part of the ba subtree. Still, it can be cleaned up, and it should not be public the whole world. It's very misleading considering the package name is org.osate.utils.

• Aadl2Utils and Aadl2Visitors see more heavy usage within the ba subtree, and may be harder to get rid of. But we still find a way of shielding them from public use.
• Should be made .internal.

[AaronGreenhouse]

The class org.osate.aadl2.modelsupport.resources.OsateResourceUtil now only has the methods toIFile(URI) and toResourceURI(IResource). These methods are used a lot and are unfortunately necessary for dealing mapping between EMF and Eclipse file resources.

[AaronGreenhouse]

Actually, the whole plugin org.osate.aadl2.modelsupport seems to want to be part of the API.

[AaronGreenhouse]

Class org.osate.ui.utils.FileUtils is a copy of org.osate.ui.FileUtils!

It seems to be there because org.osate.ui.wizards.AadlExamplesWizard seems to be a. copy and modify of AadlBaAbstractyWizard?

In any case, FileUtils should be a replaced with appropriate Eclipse resource apis.

[AaronGreenhouse]

Class org.osate.ge.internal.ui.util.UiUtil is not the same as class org.osate.ui.UiUtil. The GE version is at least marked as internal so we can leave that one alone.

[AaronGreenhouse]

Class org.osate.ui.UiUtil is a reasonable concept. Seems like it should be part of the 3rd party UI, but needs some cleanup.

• The methods BestDecPoint(), OneDecPoint(), and TwoDecPoint() seem out of place. They are used by the latency analysis. (TwoDecPoint() is not used at all.)
• Not sure about the usefulness of executeCommand() and openEditorAndExcecute(). The first one isn't used, and the second one is only used by AbstractAaxlEditorMarkerResolution which isn't used anywhere. Seems obsolete.

[AaronGreenhouse]

org.osate.aadl2.instance.util.InstanceUtil looks important: deals with prototype resolution. According to Lutz it was only meant to be used during instantiation. Apparently Peter added a few more methods to it.

• getComponentClassifier() is used by org.osate.analysis.resource.management.handlers.Binpack which is probably wrong.
• isNoMode() is called from Aadl2Util printable SOM methods. Also used from EndToEndFlowInstance.isActive() which is weird because it doesn't resemble the other isActive() methods. In any case, this method should be moved somewhere else.
• There are several methods that aren't used at all.
• This class should be put into an .internal. package

How does InstanceUtil relate to org.osate.aadl2.modelsupport.util.ResolvePrototypeUtil which also deal with prototypes?

• This is used by the graphical editor and the properties linking/scoping classes.

[AaronGreenhouse]

Note: Utility classes should be final and contain a single private constructor.

[AaronGreenhouse]

Class org.osate.aadl2.parsesupport.ParseUtil also seems important. Looks like it supports parsing in annexes and sublanguages? Need more info on this.

[AaronGreenhouse]

Most of the methods in org.osate.aadl2.util.Aadl2InstanceUtil are not used. But some of them are used in the instantiation process and in other places.

[AaronGreenhouse]

Most of org.osate.aadl2.util.Aadl2Util seems legit.

Question:

• Should we always be using isNull()? When do we have to worry about proxy nodes?

[AaronGreenhouse]

Class org.osate.aadl2.modelsupport.scoping.Aadl2GlobalScopeUtil seems important; supports annex and sub-languages. Seems strange it is in a different plugin than ParseUtil.

[AaronGreenhouse]

Aadl2InstanceUtil.getResourcePath() and Aadl2InstanceUtil.makeSureFoldersExist() are out of place. Should be in OsateResourceUtil?

AadlUtil does appear to get a lot of use. But it should probably also be split up into different subjects.

• Seems to be declarative model related.