it.polito.appeal.traci

Class SumoTraciConnection

Object

it.polito.appeal.traci.SumoTraciConnection

public class SumoTraciConnection
extends Object

Models a TCP/IP connection to a local or remote SUMO server via the TraCI protocol.

Author:

Enrico Gueli <enrico.gueli@gmail.com>, Mario Krumnow

Constructor Summary

Constructors

Constructor and Description
SumoTraciConnection(java.net.SocketAddress sockAddr)
SumoTraciConnection(String configFile, int randomSeed, boolean useGeoOffset)
SumoTraciConnection(String sumo_bin, String configFile)
SumoTraciConnection(String sumo_bin, String net_file, String route_file)

Method Summary

Methods

Modifier and Type	Method and Description
void	addOption(String option, String value) Adds a custom option to the SUMO command line before executing it.
void	close() Closes the connection, quits the simulator, frees any stale resource and makes all Vehicle instances inactive.
Object	do_job_get(SumoCommand cmd)
void	do_job_set(SumoCommand cmd)
void	do_timestep()
boolean	isClosed() Returns true if the connection was closed by the user, or if an IOException was thrown after the connection was made.
void	runServer() Runs a SUMO instance and tries to connect at it.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SumoTraciConnection

public SumoTraciConnection(String sumo_bin,
                   String net_file,
                   String route_file)

SumoTraciConnection

public SumoTraciConnection(String sumo_bin,
                   String configFile)

SumoTraciConnection

public SumoTraciConnection(String configFile,
                   int randomSeed,
                   boolean useGeoOffset)

SumoTraciConnection

public SumoTraciConnection(java.net.SocketAddress sockAddr)
                    throws java.io.IOException,
                           InterruptedException

Throws:

java.io.IOException

InterruptedException

Method Detail

addOption

public void addOption(String option,
             String value)

Adds a custom option to the SUMO command line before executing it.

Parameters:

option - the option name, in long form (e.g. "no-warnings" instead of "W") and without initial dashes

value - the option value, or null if the option has no value

runServer

public void runServer()
               throws java.io.IOException

Runs a SUMO instance and tries to connect at it.

Throws:

java.io.IOException - if something wrong occurs while starting SUMO or connecting at it.

close

public void close()

Closes the connection, quits the simulator, frees any stale resource and makes all Vehicle instances inactive.

Throws:

InterruptedException - if the current thread was interrupted while waiting for SUMO to close.

isClosed

public boolean isClosed()

Returns true if the connection was closed by the user, or if an IOException was thrown after the connection was made.

See Also:

close()

do_job_set

public void do_job_set(SumoCommand cmd)
                throws Exception

Throws:

Exception

do_job_get

public Object do_job_get(SumoCommand cmd)
                  throws Exception

Throws:

Exception

do_timestep

public void do_timestep()
                 throws Exception

Throws:

Exception