Development Tools

Sequence Diagrams

Framework supports generating runtime Sequence Diagrams when debug mode is enabled (setting Oskari.setDebugMode(true);). Run this in browser console to get a Sequence Diagram of requests and events:

Oskari.getSandbox().popUpSeqDiagram();

API documentation

The JavaScript API documentation is created from source comments/annotations using ​YUIDoc. The results can be seen in here.

Object type quick guide

  • Text = {String}

  • Boolean = {Boolean}

  • Numeric values = {Number}

  • Oskari class = {Oskari.<mynamespace>.bundle.<mybundle>.MyClass}

  • Multiple possible values = for example {Number/OpenLayers.Bounds}

  • JSON "configuration" = {Object}

  • Try not to use Array or Object if you have any chance to be more specific. For example instead of {Array} you could use {String[]}

  • Class documentation with @class <class name>

  • Method documentation with @method <method name>

  • Mark methods that are only used internally with @private and prefix method name with _.

  • Mark parameters with @param {<Type>} <paramname>

  • Mark return value with @return {<Type>}

Editors

  • Sublime Text is the Oskari team's editor of choice for JavaScript development
  • IntelliJ IDEA has been found useful IDE for Oskari Java development.
  • If you're developing on a Windows machine, we recommend using Cygwin

Profiler

[![YoutKit profiler](/images/yourkit2.png)](http://www.yourkit.com)
YourKit supports Oskari open source project with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products:
    [YourKit Java Profiler](http://www.yourkit.com/java/profiler/index.jsp)
    and
    [YourKit .NET Profiler](http://www.yourkit.com/.net/profiler/index.jsp)
</div>

Last modified: Mon Sep 11 2023 18:13:06 GMT+0300 (Eastern European Summer Time)