no.nordicsemi.android.log

Class LogSession

java.lang.Object

no.nordicsemi.android.log.LogSession

All Implemented Interfaces:

ILogSession

public class LogSession
extends java.lang.Object
implements ILogSession

The log session. This object can be created with the use of Logger.newSession(Context, String, String) and is used to append new log entries to the nRF Logger log.

Method Summary

Modifier and Type	Method and Description
android.content.Context	getContext() Returns the application context.
android.net.Uri	getSessionContentUri() Returns the session read-only content Uri.
android.net.Uri	getSessionEntriesUri() Returns the session entries Uri.
android.net.Uri	getSessionsUri() Returns the Uri that may by used to obtain all sessions created by the same application (and the same profile) as this session.
android.net.Uri	getSessionUri() Returns the session Uri.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getContext

@NonNull
public android.content.Context getContext()

Description copied from interface: ILogSession

Returns the application context.

Specified by:

getContext in interface ILogSession

Returns:

The context.

getSessionUri

@NonNull
public android.net.Uri getSessionUri()

Description copied from interface: ILogSession

Returns the session Uri. The Uri may be saved in Activity.onSaveInstanceState(android.os.Bundle) to recreate the session using Logger.openSession(Context, Uri) when orientation change. Use this Uri also to open the log session in the nRF Logger.

 Intent intent = new Intent(Intent.ACTION_VIEW, mLogSession.getSessionUri());
 startActivity(intent);
 

Specified by:

getSessionUri in interface ILogSession

Returns:

The session Uri.

getSessionEntriesUri

@NonNull
public android.net.Uri getSessionEntriesUri()

Description copied from interface: ILogSession

Returns the session entries Uri. New log entries may be inserted using this Uri.

Specified by:

getSessionEntriesUri in interface ILogSession

Returns:

The session entries Uri.

getSessionsUri

@Nullable
public android.net.Uri getSessionsUri()

Returns the Uri that may by used to obtain all sessions created by the same application (and the same profile) as this session. It may be used to open the list of log sessions in the nRF Logger application or to obtain list of sessions using ContentProvider. Keep in mind that sessions with LogContract.SessionColumns.NUMBER equal to 0 are "date sessions". Date sessions are created each time a new session is being added by the application (and profile) in a new day. See Logger for more information.

 Intent intent = new Intent(Intent.ACTION_VIEW, mLogSession.getSessionsUri());
 startActivity(intent);
 

Returns:

The Uri for all sessions created by the app used to create this session or null if the session Uri is invalid or the owner app data does not exist in the database.

getSessionContentUri

@NonNull
public android.net.Uri getSessionContentUri()

Description copied from interface: ILogSession

Returns the session read-only content Uri. It can be used to obtain all log entries in a single row (as a String field) with fixed syntax, e.g.:

 [Application name], [Creation date]
 [Session name] ([Session key])
 D      10.34.01.124    This is the oldest log message (debug)
 V      10.34.02.238    This is the log message (verbose)
 I      10.34.03.527    This is the log message (info)
 A      10.34.04.612    This is the log message (application)
 W      10.34.04.812    This is the log message (warning)
 E      10.34.05.452    This is the newest log message (error)
 

Specified by:

getSessionContentUri in interface ILogSession

Returns:

The Uri that can be read using ContentResolver.query(Uri, String[], String, String[], String) method. The value will be in the first row, column number 0 (with id: LogContract.Session.Content.CONTENT).

toString

@NonNull
public java.lang.String toString()

Overrides:

toString in class java.lang.Object