Java Management Extensions (JMX) MBean komponensek specifikus mezői

A JMX attribútumcsoport mutatószám név szintaxisa pontokkal tagolt tokenekből áll. A tokenek elsődleges, és talán másodlagos értékeket is alkotnak:

• Elsődleges érték: az MBean összetevőtől vagy a Notification objektumtól közvetlenül beszerzett érték a táblázat egy bizonyos sorában. Az MBean komponenstől származó elsődleges értékeket egy MBean attribútumtól vagy egy MBean művelet hívásából (metódushívás) lehet beszerezni. Az Értesítésből származó elsődleges értékeket egy mezőből vagy egy módszer meghívásából lehet beszerezni az Értesítés objektumon. Az elsődleges értékek lehetnek primitív típusok vagy Java™ objektumok.
• Másodlagos érték: egy elsődleges érték vagy más másodlagos érték további feldolgozásából származó érték. A másodlagos értékek az alrendszeren belül kerülnek feldolgozásra, és nem foglalnak magukban hívásokat a JMX kiszolgálóhoz. Ha az elsődleges (vagy egyéb másodlagos) érték Java objektum, akkor a másodlagos érték az objektum egy nyilvános mezőjének lehívásából származik. A másodlagos érték emellett az objektumon végrehajtott metódushívás eredménye is lehet. Az ilyen másodlagos értékek az elsődleges (vagy egyéb másodlagos) Java objektum Java betekintésének használatával szerezhetők be. Ha az elsődleges (vagy egyéb másodlagos) érték Java karakterlánc egy MBean név formájában, akkor a másodlagos érték lehet a tartomány. A másodlagos érték lehet továbbá az MBean név által tartalmazott bármely más tulajdonság.

A következő szintaxis írja le a Mutatószám neve mező formátumát:

Metric Name	=	PrimaryValue [ .SecondaryValue ]
PrimaryValue	=	Attribute.attributeName |
		Method.methodName |
		Domain |
		Property.propertyName |
		Field.fieldName |
		Név
SecondaryValue	=	Field.fieldName |
		Method.methodName |
		Domain |
		Property.propertyName |
		Explode |
		ElementCount

propertyName	=	the name of a key property in an MBean ObjectName
attributeName	=	the name of an MBean attribute
methodName	=	a zero-argument operation of an MBean or a zero-argument method 
of a Notification or other Java object. 
methodName(argument) = A single-argument operation of an MBean or a 
single-argument method of a Notification or other Java object. A 
argument will be passed to the method as a string.
fieldName	=	the name of a public instance variable in a Notification or 
other Java object
notificationMethod	=	the name of a public zero-argument method of a 
Notification object

Ha a mutatószámnév meghatározása csak egy elsődleges értéket tartalmaz, akkor a begyűjtött adatok a következők lehetnek:

• MBean tartomány
• MBean karaktersorozat érték
• Kulcs tulajdonság az MBean nevéből
• Numerikus vagy karakterlánc attribútumérték egy MBean attribútumon (beleértve egy másik MBean teljes nevét). Egy numerikus vagy karakterlánc visszatérési érték az egyik MBean műveletből.
• Egy numerikus vagy karaktersorozat típusú nyilvános példányváltozó értéke egy Notification objektumban
• Numerikus vagy karakterlánc visszatérési érték egy Notification objektum egyik műveletéből.

Az elsődleges és másodlagos értékeket kitevő tokenek kulcsszavak vagy nevek. A legtöbb esetben a kulcsszó tokent név token követi. A következő táblázat néhány példát mutat:

Az Attribútum, Metódus és Mező kulcsszavak olyan Java objektumokat adhatnak vissza, amelyek más adatokat tartalmaznak. Ezeken az objektumokon úgy hajthat végre műveleteket, ha másodlagos érték meghatározásokat fűz hozzájuk. További példák:

A Domain és a Property használható kulcsszóként másodlagos értékekben, ha az előző érték karakterláncot adott vissza egy MBean név formájában. Például:

Az ElementCount és az Explode kulcsszavak tömbökön vagy adatgyűjteményeken hajtanak végre műveleteket.

• ElementCount – egy tömb elemeinek számát adja vissza.
• Explode – egy sort több sorra bont, így egy-egy sor jut a tömb minden eleme számára.

Példák az egyes kulcsszavakra: