stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge

Browse Source
This commit is contained in:
Lana Steuck 2014-04-01 17:25:55 -07:00
commit ed8ccafaa0
634 changed files with 49262 additions and 51620 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
jdk/make/CompileJavaClasses.gmk
View File

@ -267,6 +267,20 @@ ifndef OPENJDK
$(JDK_TOPDIR)/src/closed/$(OPENJDK_TARGET_OS_API_DIR)/classes $(JDK_TOPDIR)/src/closed/$(OPENJDK_TARGET_OS_API_DIR)/classes
endif endif
# No SCTP implementation on Mac OS X or AIX. These classes should be excluded.
SCTP_IMPL_CLASSES = \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/AssociationChange.java\
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/AssociationImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/PeerAddrChange.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/ResultContainer.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpChannelImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpMultiChannelImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpNet.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpNotification.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpServerChannelImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SendFailed.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/Shutdown.java
MACOSX_SRC_DIRS := MACOSX_SRC_DIRS :=
ifeq ($(OPENJDK_TARGET_OS), macosx) ifeq ($(OPENJDK_TARGET_OS), macosx)
MACOSX_SRC_DIRS += $(JDK_TOPDIR)/src/macosx/classes MACOSX_SRC_DIRS += $(JDK_TOPDIR)/src/macosx/classes
@ -278,9 +292,7 @@ ifeq ($(OPENJDK_TARGET_OS), macosx)
$(JDK_TOPDIR)/src/solaris/classes/java/lang/ClassLoaderHelper.java \ $(JDK_TOPDIR)/src/solaris/classes/java/lang/ClassLoaderHelper.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/util/locale/provider/HostLocaleProviderAdapterImpl.java \ $(JDK_TOPDIR)/src/solaris/classes/sun/util/locale/provider/HostLocaleProviderAdapterImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/fs/GnomeFileTypeDetector.java \ $(JDK_TOPDIR)/src/solaris/classes/sun/nio/fs/GnomeFileTypeDetector.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpChannelImpl.java \ EXFILES += $(SCTP_IMPL_CLASSES)
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpMultiChannelImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpServerChannelImpl.java
endif endif
@ -302,9 +314,7 @@ ifeq ($(OPENJDK_TARGET_OS),aix)
AIX_SRC_DIRS += $(JDK_TOPDIR)/src/aix/classes AIX_SRC_DIRS += $(JDK_TOPDIR)/src/aix/classes
# these files are duplicated in AIX_SRC_DIRS # these files are duplicated in AIX_SRC_DIRS
EXFILES += $(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpChannelImpl.java \ EXFILES += $(SCTP_IMPL_CLASSES)
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpMultiChannelImpl.java \
$(JDK_TOPDIR)/src/solaris/classes/sun/nio/ch/sctp/SctpServerChannelImpl.java
endif endif
# The JDK_USER_DEFINED_FILTER is a poor man's incremental build: by specifying # The JDK_USER_DEFINED_FILTER is a poor man's incremental build: by specifying

7
jdk/make/CompileLaunchers.gmk
View File

@ -1,5 +1,5 @@
# #
# Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. # Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
# #
# This code is free software; you can redistribute it and/or modify it # This code is free software; you can redistribute it and/or modify it
@ -679,7 +679,10 @@ ifndef OPENJDK
PROGRAM := jabswitch, \ PROGRAM := jabswitch, \
DEBUG_SYMBOLS := true, \ DEBUG_SYMBOLS := true, \
VERSIONINFO_RESOURCE := $(JDK_TOPDIR)/src/closed/windows/native/sun/bridge/AccessBridgeStatusWindow.rc, \ VERSIONINFO_RESOURCE := $(JDK_TOPDIR)/src/closed/windows/native/sun/bridge/AccessBridgeStatusWindow.rc, \
RC_FLAGS := $(RC_FLAGS), \ RC_FLAGS := $(RC_FLAGS) \
-D "JDK_FNAME=jabswitch.exe" \
-D "JDK_INTERNAL_NAME=jabswitch" \
-D "JDK_FTYPE=0x01L", \
MANIFEST := $(JDK_TOPDIR)/src/closed/windows/native/sun/bridge/jabswitch.manifest)) MANIFEST := $(JDK_TOPDIR)/src/closed/windows/native/sun/bridge/jabswitch.manifest))
BUILD_LAUNCHERS += $(BUILD_JABSWITCH) BUILD_LAUNCHERS += $(BUILD_JABSWITCH)

57
jdk/make/Images.gmk
View File

@ -301,10 +301,15 @@ $(JDK_IMAGE_DIR)/jre/lib/ext/meta-index: $(JDKJRE_LIB_TARGETS)
################################################################################ ################################################################################
# /man dir # /man dir
#
# All variables in this section are assigned with simple =, without :, to enable
# more selective overriding from the custom version of this file.
#
# Avoid evaluating this whole section on windows for speed and stability # Avoid evaluating this whole section on windows for speed and stability
ifneq ($(OPENJDK_TARGET_OS), windows) ifneq ($(OPENJDK_TARGET_OS), windows)
JRE_MAN_PAGES := \ JRE_MAN_PAGES = \
java.1 \ java.1 \
jjs.1 \
keytool.1 \ keytool.1 \
orbd.1 \ orbd.1 \
pack200.1 \ pack200.1 \
@ -335,6 +340,7 @@ ifneq ($(OPENJDK_TARGET_OS), windows)
jconsole.1 \ jconsole.1 \
jcmd.1 \ jcmd.1 \
jdb.1 \ jdb.1 \
jdeps.1 \
jhat.1 \ jhat.1 \
jinfo.1 \ jinfo.1 \
jmap.1 \ jmap.1 \
@ -352,29 +358,22 @@ ifneq ($(OPENJDK_TARGET_OS), windows)
wsimport.1 \ wsimport.1 \
xjc.1 xjc.1
ifndef OPENJDK
JDK_MAN_PAGES += jvisualvm.1
endif
# This variable is potentially overridden in the closed makefile. # This variable is potentially overridden in the closed makefile.
MAN_SRC_BASEDIR ?= $(JDK_TOPDIR)/src MAN_SRC_BASEDIR ?= $(JDK_TOPDIR)/src
ifeq ($(OPENJDK_TARGET_OS), linux) ifeq ($(OPENJDK_TARGET_OS), linux)
MAN_SRC_DIR := $(MAN_SRC_BASEDIR)/linux/doc MAN_SRC_DIR = $(MAN_SRC_BASEDIR)/linux/doc
MAN1_SUBDIR := man MAN1_SUBDIR = man
endif endif
ifeq ($(OPENJDK_TARGET_OS), solaris) ifeq ($(OPENJDK_TARGET_OS), solaris)
MAN_SRC_DIR := $(MAN_SRC_BASEDIR)/solaris/doc MAN_SRC_DIR = $(MAN_SRC_BASEDIR)/solaris/doc
MAN1_SUBDIR := sun/man/man1 MAN1_SUBDIR = sun/man/man1
endif endif
ifeq ($(OPENJDK_TARGET_OS), macosx) ifeq ($(OPENJDK_TARGET_OS), macosx)
MAN_SRC_DIR := $(MAN_SRC_BASEDIR)/bsd/doc MAN_SRC_DIR = $(MAN_SRC_BASEDIR)/bsd/doc
MAN1_SUBDIR := man MAN1_SUBDIR = man
JDK_MAN_PAGES := $(filter-out jcmd.1, $(JDK_MAN_PAGES))
JDK_MAN_PAGES := $(filter-out jvisualvm.1, $(JDK_MAN_PAGES))
endif endif
$(JRE_IMAGE_DIR)/man/man1/%: $(MAN_SRC_DIR)/$(MAN1_SUBDIR)/% $(JRE_IMAGE_DIR)/man/man1/%: $(MAN_SRC_DIR)/$(MAN1_SUBDIR)/%
$(ECHO) $(LOG_INFO) Copying $(patsubst $(OUTPUT_ROOT)/%,%,$@) $(ECHO) $(LOG_INFO) Copying $(patsubst $(OUTPUT_ROOT)/%,%,$@)
$(install-file) $(install-file)
@ -426,12 +425,6 @@ ifneq ($(OPENJDK_TARGET_OS), windows)
$(install-file) $(install-file)
endif endif
# Old build creates empty man page for this, mimicing behaviour.
$(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/jcmd.1 $(JDK_IMAGE_DIR)/man/ja_JP.PCK/man1/jcmd.1 $(JDK_IMAGE_DIR)/man/ja/man1/jcmd.1:
$(ECHO) $(LOG_INFO) Creating dummy $(patsubst $(OUTPUT_ROOT)/%,%,$@)
$(MKDIR) -p $(@D)
$(TOUCH) $@
ifeq ($(OPENJDK_TARGET_OS), linux) ifeq ($(OPENJDK_TARGET_OS), linux)
$(JRE_IMAGE_DIR)/man/ja: $(JRE_IMAGE_DIR)/man/ja:
$(ECHO) $(LOG_INFO) Creating $(patsubst $(OUTPUT_ROOT)/%,%,$@) $(ECHO) $(LOG_INFO) Creating $(patsubst $(OUTPUT_ROOT)/%,%,$@)
@ -453,33 +446,33 @@ ifneq ($(OPENJDK_TARGET_OS), windows)
endif endif
ifeq ($(OPENJDK_TARGET_OS), linux) ifeq ($(OPENJDK_TARGET_OS), linux)
JRE_MAN_PAGE_LIST := $(addprefix $(JRE_IMAGE_DIR)/man/man1/, $(JRE_MAN_PAGES)) \ JRE_MAN_PAGE_LIST = $(addprefix $(JRE_IMAGE_DIR)/man/man1/, $(JRE_MAN_PAGES)) \
$(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JRE_MAN_PAGES)) \ $(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JRE_MAN_PAGES)) \
$(JRE_IMAGE_DIR)/man/ja $(JRE_IMAGE_DIR)/man/ja
JDK_MAN_PAGE_LIST := $(addprefix $(JDK_IMAGE_DIR)/man/man1/, $(JDK_MAN_PAGES)) \ JDK_MAN_PAGE_LIST = $(addprefix $(JDK_IMAGE_DIR)/man/man1/, $(JDK_MAN_PAGES)) \
$(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JDK_MAN_PAGES)) \ $(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JDK_MAN_PAGES)) \
$(JDK_IMAGE_DIR)/man/ja $(JDK_IMAGE_DIR)/man/ja
endif endif
ifeq ($(OPENJDK_TARGET_OS), solaris) ifeq ($(OPENJDK_TARGET_OS), solaris)
JRE_MAN_PAGE_LIST := $(addprefix $(JRE_IMAGE_DIR)/man/man1/, $(JRE_MAN_PAGES)) \ JRE_MAN_PAGE_LIST = $(addprefix $(JRE_IMAGE_DIR)/man/man1/, $(JRE_MAN_PAGES)) \
$(addprefix $(JRE_IMAGE_DIR)/man/ja/man1/, $(JRE_MAN_PAGES)) \ $(addprefix $(JRE_IMAGE_DIR)/man/ja/man1/, $(JRE_MAN_PAGES)) \
$(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JRE_MAN_PAGES)) \ $(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JRE_MAN_PAGES)) \
$(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.PCK/man1/, $(JRE_MAN_PAGES)) $(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.PCK/man1/, $(JRE_MAN_PAGES))
JDK_MAN_PAGE_LIST := $(addprefix $(JDK_IMAGE_DIR)/man/man1/, $(JDK_MAN_PAGES)) \ JDK_MAN_PAGE_LIST = $(addprefix $(JDK_IMAGE_DIR)/man/man1/, $(JDK_MAN_PAGES)) \
$(addprefix $(JDK_IMAGE_DIR)/man/ja/man1/, $(JDK_MAN_PAGES)) \ $(addprefix $(JDK_IMAGE_DIR)/man/ja/man1/, $(JDK_MAN_PAGES)) \
$(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JDK_MAN_PAGES)) \ $(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JDK_MAN_PAGES)) \
$(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.PCK/man1/, $(JDK_MAN_PAGES)) $(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.PCK/man1/, $(JDK_MAN_PAGES))
endif endif
ifeq ($(OPENJDK_TARGET_OS), macosx) ifeq ($(OPENJDK_TARGET_OS), macosx)
JRE_MAN_PAGE_LIST := $(addprefix $(JRE_IMAGE_DIR)/man/man1/, $(JRE_MAN_PAGES)) \ JRE_MAN_PAGE_LIST = $(addprefix $(JRE_IMAGE_DIR)/man/man1/, $(JRE_MAN_PAGES)) \
$(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JRE_MAN_PAGES)) \ $(addprefix $(JRE_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JRE_MAN_PAGES)) \
$(JRE_IMAGE_DIR)/man/ja $(JRE_IMAGE_DIR)/man/ja
JDK_MAN_PAGE_LIST := $(addprefix $(JDK_IMAGE_DIR)/man/man1/, $(JDK_MAN_PAGES)) \ JDK_MAN_PAGE_LIST = $(addprefix $(JDK_IMAGE_DIR)/man/man1/, $(JDK_MAN_PAGES)) \
$(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JDK_MAN_PAGES)) \ $(addprefix $(JDK_IMAGE_DIR)/man/ja_JP.UTF-8/man1/, $(JDK_MAN_PAGES)) \
$(JDK_IMAGE_DIR)/man/ja $(JDK_IMAGE_DIR)/man/ja
endif endif
@ -733,6 +726,13 @@ ifneq ($(POST_STRIP_CMD), )
endif endif
################################################################################
# Include the custom makefile right here, after all variables have been defined
# so that they may be overridden, but before the main targets are declared, so
# that overriding has an effect.
$(eval $(call IncludeCustomExtension, jdk, Images.gmk))
################################################################################ ################################################################################
# Main targets # Main targets
@ -782,6 +782,3 @@ endif # Profile
################################################################################ ################################################################################
.PHONY: default images jre-image jdk-image .PHONY: default images jre-image jdk-image
# Hook to include the corresponding custom file, if present.
$(eval $(call IncludeCustomExtension, jdk, Images.gmk))

1
jdk/make/Tools.gmk
View File

@ -71,6 +71,7 @@ TOOL_CHARACTERNAME = $(JAVA_SMALL) -cp $(JDK_OUTPUTDIR)/btclasses \
build.tools.generatecharacter.CharacterName build.tools.generatecharacter.CharacterName
TOOL_DTDBUILDER = $(JAVA_SMALL) -Ddtd_home=$(JDK_TOPDIR)/make/data/dtdbuilder \ TOOL_DTDBUILDER = $(JAVA_SMALL) -Ddtd_home=$(JDK_TOPDIR)/make/data/dtdbuilder \
-Djava.awt.headless=true \
-cp $(JDK_OUTPUTDIR)/btclasses build.tools.dtdbuilder.DTDBuilder -cp $(JDK_OUTPUTDIR)/btclasses build.tools.dtdbuilder.DTDBuilder
TOOL_GENERATEBREAKITERATORDATA = $(JAVA_SMALL) \ TOOL_GENERATEBREAKITERATORDATA = $(JAVA_SMALL) \

30
jdk/make/lib/Awt2dLibraries.gmk
View File

@ -26,9 +26,6 @@
# Hook to include the corresponding custom file, if present. # Hook to include the corresponding custom file, if present.
$(eval $(call IncludeCustomExtension, jdk, lib/Awt2dLibraries.gmk)) $(eval $(call IncludeCustomExtension, jdk, lib/Awt2dLibraries.gmk))
# Openwin is defined on Solaris.
OPENWIN_LIB := $(OPENWIN_HOME)/lib
WIN_AWT_LIB := $(JDK_OUTPUTDIR)/objs/libawt/awt.lib WIN_AWT_LIB := $(JDK_OUTPUTDIR)/objs/libawt/awt.lib
########################################################################################## ##########################################################################################
@ -481,7 +478,6 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBAWT, \
ASFLAGS := $(LIBAWT_ASFLAGS), \ ASFLAGS := $(LIBAWT_ASFLAGS), \
MAPFILE := $(LIBAWT_MAPFILE), \ MAPFILE := $(LIBAWT_MAPFILE), \
LDFLAGS := $(LDFLAGS_JDKLIB) $(call SET_SHARED_LIBRARY_ORIGIN), \ LDFLAGS := $(LDFLAGS_JDKLIB) $(call SET_SHARED_LIBRARY_ORIGIN), \
LDFLAGS_solaris := -R/usr/dt/lib$(OPENJDK_TARGET_CPU_ISADIR) -R$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR), \
LDFLAGS_SUFFIX_linux := -ljvm $(LIBM) $(LIBDL) -ljava, \ LDFLAGS_SUFFIX_linux := -ljvm $(LIBM) $(LIBDL) -ljava, \
LDFLAGS_SUFFIX_solaris := -ljvm $(LIBM) $(LIBDL) -ljava -lc, \ LDFLAGS_SUFFIX_solaris := -ljvm $(LIBM) $(LIBDL) -ljava -lc, \
LDFLAGS_SUFFIX_aix :=-ljvm $(LIBM) $(LIBDL) -ljava -lm,\ LDFLAGS_SUFFIX_aix :=-ljvm $(LIBM) $(LIBDL) -ljava -lm,\
@ -638,14 +634,7 @@ ifeq ($(findstring $(OPENJDK_TARGET_OS),windows macosx),)
$(X_CFLAGS), \ $(X_CFLAGS), \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libawt_xawt/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libawt_xawt/mapfile-vers, \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
$(X_LIBS) $(LIBAWT_XAWT_LDFLAGS), \ $(X_LIBS) $(LIBAWT_XAWT_LDFLAGS) \
LDFLAGS_linux := $(call SET_SHARED_LIBRARY_ORIGIN) \
$(call SET_SHARED_LIBRARY_ORIGIN,/..), \
LDFLAGS_solaris := -L$(OPENWIN_HOME)/sfw/lib$(OPENJDK_TARGET_CPU_ISADIR) \
-L$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR) \
-R$(OPENWIN_HOME)/sfw/lib$(OPENJDK_TARGET_CPU_ISADIR) \
-R$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR) \
-R/usr/dt/lib$(OPENJDK_TARGET_CPU_ISADIR) \
$(call SET_SHARED_LIBRARY_ORIGIN) \ $(call SET_SHARED_LIBRARY_ORIGIN) \
$(call SET_SHARED_LIBRARY_ORIGIN,/..), \ $(call SET_SHARED_LIBRARY_ORIGIN,/..), \
LDFLAGS_SUFFIX := $(LIBAWT_XAWT_LDFLAGS_SUFFIX), \ LDFLAGS_SUFFIX := $(LIBAWT_XAWT_LDFLAGS_SUFFIX), \
@ -976,7 +965,7 @@ else # OPENJDK_TARGET_OS not windows
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjawt/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjawt/mapfile-vers, \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
$(call SET_SHARED_LIBRARY_ORIGIN), \ $(call SET_SHARED_LIBRARY_ORIGIN), \
LDFLAGS_solaris := -L$(OPENWIN_HOME)/sfw/lib$(OPENJDK_TARGET_CPU_ISADIR) -L$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR), \ LDFLAGS_solaris := $(X_LIBS), \
LDFLAGS_SUFFIX_linux := $(JAWT_LIBS) $(LDFLAGS_JDKLIB_SUFFIX), \ LDFLAGS_SUFFIX_linux := $(JAWT_LIBS) $(LDFLAGS_JDKLIB_SUFFIX), \
LDFLAGS_SUFFIX_aix := $(JAWT_LIBS) $(LDFLAGS_JDKLIB_SUFFIX),\ LDFLAGS_SUFFIX_aix := $(JAWT_LIBS) $(LDFLAGS_JDKLIB_SUFFIX),\
LDFLAGS_SUFFIX_solaris := $(JAWT_LIBS) $(LDFLAGS_JDKLIB_SUFFIX) -lXrender, \ LDFLAGS_SUFFIX_solaris := $(JAWT_LIBS) $(LDFLAGS_JDKLIB_SUFFIX) -lXrender, \
@ -1074,11 +1063,11 @@ ifndef OPENJDK
CFLAGS := $(CFLAGS_JDKLIB) \ CFLAGS := $(CFLAGS_JDKLIB) \
-I$(JDK_TOPDIR)/src/share/javavm/export \ -I$(JDK_TOPDIR)/src/share/javavm/export \
-I$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/javavm/export \ -I$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/javavm/export \
-I$(OPENWIN_HOME)/include, \ $(X_CFLAGS), \
MAPFILE := $(SUNWJDGA_MAPFILE), \ MAPFILE := $(SUNWJDGA_MAPFILE), \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
$(call SET_SHARED_LIBRARY_ORIGIN), \ $(call SET_SHARED_LIBRARY_ORIGIN), \
LDFLAGS_SUFFIX := -L$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR) -R$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR) -ldga -lX11 $(LIBDL) -lc, \ LDFLAGS_SUFFIX := $(X_LIBS) -ldga -lX11 $(LIBDL) -lc, \
OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libsunwjdga, \ OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libsunwjdga, \
DEBUG_SYMBOLS := $(DEBUG_ALL_BINARIES))) DEBUG_SYMBOLS := $(DEBUG_ALL_BINARIES)))
@ -1173,9 +1162,7 @@ ifeq ($(BUILD_HEADLESS), true)
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
$(call SET_SHARED_LIBRARY_ORIGIN), \ $(call SET_SHARED_LIBRARY_ORIGIN), \
LDFLAGS_linux := $(call SET_SHARED_LIBRARY_ORIGIN,/..), \ LDFLAGS_linux := $(call SET_SHARED_LIBRARY_ORIGIN,/..), \
LDFLAGS_solaris := $(call SET_SHARED_LIBRARY_ORIGIN,/..) \ LDFLAGS_solaris := $(call SET_SHARED_LIBRARY_ORIGIN,/..), \
-R/usr/dt/lib$(OPENJDK_TARGET_CPU_ISADIR) \
-R$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR), \
LDFLAGS_macosx := $(call SET_SHARED_LIBRARY_ORIGIN)., \ LDFLAGS_macosx := $(call SET_SHARED_LIBRARY_ORIGIN)., \
REORDER := $(LIBAWT_HEADLESS_REORDER), \ REORDER := $(LIBAWT_HEADLESS_REORDER), \
LDFLAGS_SUFFIX_linux := -ljvm -lawt -lm $(LIBDL) -ljava, \ LDFLAGS_SUFFIX_linux := -ljvm -lawt -lm $(LIBDL) -ljava, \
@ -1236,8 +1223,6 @@ ifndef BUILD_HEADLESS_ONLY
else ifeq ($(OPENJDK_TARGET_OS), windows) else ifeq ($(OPENJDK_TARGET_OS), windows)
LIBSPLASHSCREEN_CFLAGS += -DWITH_WIN32 LIBSPLASHSCREEN_CFLAGS += -DWITH_WIN32
else ifeq ($(OPENJDK_TARGET_OS), solaris)
LIBSPLASHSCREEN_CFLAGS += -DWITH_X11 -I$(OPENWIN_HOME)/include -I$(OPENWIN_HOME)/include/X11/extensions
else else
LIBSPLASHSCREEN_CFLAGS += -DWITH_X11 $(X_CFLAGS) LIBSPLASHSCREEN_CFLAGS += -DWITH_X11 $(X_CFLAGS)
endif endif
@ -1258,10 +1243,7 @@ ifndef BUILD_HEADLESS_ONLY
-framework JavaNativeFoundation -framework JavaNativeFoundation
else ifeq ($(OPENJDK_TARGET_OS), windows) else ifeq ($(OPENJDK_TARGET_OS), windows)
LIBSPLASHSCREEN_LDFLAGS_SUFFIX += kernel32.lib user32.lib gdi32.lib delayimp.lib -DELAYLOAD:user32.dll LIBSPLASHSCREEN_LDFLAGS_SUFFIX += kernel32.lib user32.lib gdi32.lib delayimp.lib -DELAYLOAD:user32.dll
else ifeq ($(OPENJDK_TARGET_OS), solaris) else
# Solaris still uses OPENWIN_LIB ..
LIBSPLASHSCREEN_LDFLAGS_SUFFIX += -L$(OPENWIN_LIB)$(OPENJDK_TARGET_CPU_ISADIR) -lX11 -lXext $(LIBM) -lpthread
else # .. all other Unixes can use X_LIBS
LIBSPLASHSCREEN_LDFLAGS_SUFFIX += $(X_LIBS) -lX11 -lXext $(LIBM) -lpthread LIBSPLASHSCREEN_LDFLAGS_SUFFIX += $(X_LIBS) -lX11 -lXext $(LIBM) -lpthread
endif endif

2
jdk/make/lib/CoreLibraries.gmk
View File

@ -305,7 +305,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBPREFS, \
LDFLAGS_SUFFIX_linux := -ljvm -ljava, \ LDFLAGS_SUFFIX_linux := -ljvm -ljava, \
LDFLAGS_SUFFIX_solaris := -ljvm -ljava -lc, \ LDFLAGS_SUFFIX_solaris := -ljvm -ljava -lc, \
LDFLAGS_SUFFIX_aix := -ljvm -ljava, \ LDFLAGS_SUFFIX_aix := -ljvm -ljava, \
LDFLAGS_SUFFIX_windows := advapi32.lib, \ LDFLAGS_SUFFIX_windows := advapi32.lib jvm.lib $(WIN_JAVA_LIB), \
LDFLAGS_SUFFIX_macosx := -ljvm -framework CoreFoundation, \ LDFLAGS_SUFFIX_macosx := -ljvm -framework CoreFoundation, \
VERSIONINFO_RESOURCE := $(JDK_TOPDIR)/src/windows/resource/version.rc, \ VERSIONINFO_RESOURCE := $(JDK_TOPDIR)/src/windows/resource/version.rc, \
RC_FLAGS := $(RC_FLAGS) \ RC_FLAGS := $(RC_FLAGS) \

17
jdk/make/lib/PlatformLibraries.gmk
View File

@ -1,5 +1,5 @@
# #
# Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. # Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
# #
# This code is free software; you can redistribute it and/or modify it # This code is free software; you can redistribute it and/or modify it
@ -160,7 +160,10 @@ ifndef OPENJDK
-subsystem:windows -machine:$2 \ -subsystem:windows -machine:$2 \
-def:$(ACCESSBRIDGE_SRCDIR)/JAWTAccessBridge.DEF, \ -def:$(ACCESSBRIDGE_SRCDIR)/JAWTAccessBridge.DEF, \
VERSIONINFO_RESOURCE := $(ACCESSBRIDGE_SRCDIR)/AccessBridgeStatusWindow.rc, \ VERSIONINFO_RESOURCE := $(ACCESSBRIDGE_SRCDIR)/AccessBridgeStatusWindow.rc, \
RC_FLAGS := $(RC_FLAGS), \ RC_FLAGS := $(RC_FLAGS) \
-D "JDK_FNAME=JAWTAccessBridge$1.dll" \
-D "JDK_INTERNAL_NAME=JAWTAccessBridge$1" \
-D "JDK_FTYPE=0x02L", \
OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libjawtaccessbridge$1, \ OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libjawtaccessbridge$1, \
DEBUG_SYMBOLS := true) DEBUG_SYMBOLS := true)
@ -183,7 +186,10 @@ ifndef OPENJDK
-subsystem:windows -machine:$2 \ -subsystem:windows -machine:$2 \
-def:$(ACCESSBRIDGE_SRCDIR)/JavaAccessBridge.DEF, \ -def:$(ACCESSBRIDGE_SRCDIR)/JavaAccessBridge.DEF, \
VERSIONINFO_RESOURCE := $(ACCESSBRIDGE_SRCDIR)/AccessBridgeStatusWindow.rc, \ VERSIONINFO_RESOURCE := $(ACCESSBRIDGE_SRCDIR)/AccessBridgeStatusWindow.rc, \
RC_FLAGS := $(RC_FLAGS), \ RC_FLAGS := $(RC_FLAGS) \
-D "JDK_FNAME=JavaAccessBridge$1.dll" \
-D "JDK_INTERNAL_NAME=JavaAccessBridge$1" \
-D "JDK_FTYPE=0x02L", \
OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libjavaaccessbridge$1, \ OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libjavaaccessbridge$1, \
DEBUG_SYMBOLS := true) DEBUG_SYMBOLS := true)
@ -205,7 +211,10 @@ ifndef OPENJDK
-subsystem:windows -machine:$2 \ -subsystem:windows -machine:$2 \
-def:$(ACCESSBRIDGE_SRCDIR)/WinAccessBridge.DEF, \ -def:$(ACCESSBRIDGE_SRCDIR)/WinAccessBridge.DEF, \
VERSIONINFO_RESOURCE := $(ACCESSBRIDGE_SRCDIR)/AccessBridgeStatusWindow.rc, \ VERSIONINFO_RESOURCE := $(ACCESSBRIDGE_SRCDIR)/AccessBridgeStatusWindow.rc, \
RC_FLAGS := $(RC_FLAGS), \ RC_FLAGS := $(RC_FLAGS) \
-D "JDK_FNAME=WindowsAccessBridge$1.dll" \
-D "JDK_INTERNAL_NAME=WindowsAccessBridge$1" \
-D "JDK_FTYPE=0x02L", \
OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libwindowsaccessbridge$1, \ OBJECT_DIR := $(JDK_OUTPUTDIR)/objs/libwindowsaccessbridge$1, \
DEBUG_SYMBOLS := true) DEBUG_SYMBOLS := true)

20
jdk/make/lib/ServiceabilityLibraries.gmk
View File

@ -49,7 +49,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBATTACH, \
EXCLUDE_FILES := $(LIBATTACH_EXCLUDE_FILES), \ EXCLUDE_FILES := $(LIBATTACH_EXCLUDE_FILES), \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB), \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS), \
CFLAGS_windows := /Gy, \ CFLAGS_windows := /Gy, \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libattach/mapfile-$(OPENJDK_TARGET_OS), \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libattach/mapfile-$(OPENJDK_TARGET_OS), \
VERSIONINFO_RESOURCE := $(JDK_TOPDIR)/src/windows/resource/version.rc, \ VERSIONINFO_RESOURCE := $(JDK_TOPDIR)/src/windows/resource/version.rc, \
@ -79,7 +79,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBDT_SOCKET, \
$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/socket, \ $(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/socket, \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB) -DUSE_MMAP \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_CFLAGS_WARNINGS_ARE_ERRORS) -DUSE_MMAP \
-I$(INCLUDEDIR) -I$(JDK_OUTPUTDIR)/include/$(OPENJDK_TARGET_OS) \ -I$(INCLUDEDIR) -I$(JDK_OUTPUTDIR)/include/$(OPENJDK_TARGET_OS) \
-I$(JDK_TOPDIR)/src/share/transport/socket \ -I$(JDK_TOPDIR)/src/share/transport/socket \
-I$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/socket \ -I$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/socket \
@ -115,7 +115,7 @@ ifeq ($(OPENJDK_TARGET_OS), windows)
$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/shmem, \ $(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/shmem, \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB) -DUSE_MMAP \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) -DUSE_MMAP \
-I$(INCLUDEDIR) -I$(JDK_OUTPUTDIR)/include/$(OPENJDK_TARGET_OS) \ -I$(INCLUDEDIR) -I$(JDK_OUTPUTDIR)/include/$(OPENJDK_TARGET_OS) \
-I$(JDK_TOPDIR)/src/share/transport/shmem \ -I$(JDK_TOPDIR)/src/share/transport/shmem \
-I$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/shmem \ -I$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/transport/shmem \
@ -144,7 +144,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBJDWP, \
SRC := $(JDK_TOPDIR)/src/share/back $(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/back, \ SRC := $(JDK_TOPDIR)/src/share/back $(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/back, \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB) -DJDWP_LOGGING \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) -DJDWP_LOGGING \
-I$(JDK_TOPDIR)/src/share/transport/export \ -I$(JDK_TOPDIR)/src/share/transport/export \
-I$(JDK_TOPDIR)/src/share/back/export \ -I$(JDK_TOPDIR)/src/share/back/export \
-I$(JDK_TOPDIR)/src/share/npt \ -I$(JDK_TOPDIR)/src/share/npt \
@ -179,7 +179,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBJSDT, \
$(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/native/sun/tracing/dtrace, \ $(JDK_TOPDIR)/src/$(OPENJDK_TARGET_OS_API_DIR)/native/sun/tracing/dtrace, \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB) \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) \
-I$(JDK_TOPDIR)/src/share/native/sun/tracing/dtrace, \ -I$(JDK_TOPDIR)/src/share/native/sun/tracing/dtrace, \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjsdt/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjsdt/mapfile-vers, \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
@ -248,7 +248,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBINSTRUMENT, \
INCLUDE_FILES := $(LIBINSTRUMENT_FILES), \ INCLUDE_FILES := $(LIBINSTRUMENT_FILES), \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(LIBINSTRUMENT_CFLAGS), \ CFLAGS := $(LIBINSTRUMENT_CFLAGS) $(CFLAGS_WARNINGS_ARE_ERRORS), \
CFLAGS_debug := -DJPLIS_LOGGING, \ CFLAGS_debug := -DJPLIS_LOGGING, \
CFLAGS_release := -DNO_JPLIS_LOGGING, \ CFLAGS_release := -DNO_JPLIS_LOGGING, \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libinstrument/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libinstrument/mapfile-vers, \
@ -316,7 +316,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBMANAGEMENT, \
EXCLUDE_FILES := $(BUILD_LIBMANAGEMENT_EXCLUDES), \ EXCLUDE_FILES := $(BUILD_LIBMANAGEMENT_EXCLUDES), \
LANG := C, \ LANG := C, \
OPTIMIZATION := $(LIBMANAGEMENT_OPTIMIZATION), \ OPTIMIZATION := $(LIBMANAGEMENT_OPTIMIZATION), \
CFLAGS := $(CFLAGS_JDKLIB) $(BUILD_LIBMANAGEMENT_CFLAGS), \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) $(BUILD_LIBMANAGEMENT_CFLAGS), \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libmanagement/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libmanagement/mapfile-vers, \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
$(call SET_SHARED_LIBRARY_ORIGIN), \ $(call SET_SHARED_LIBRARY_ORIGIN), \
@ -364,7 +364,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBHPROF, \
SRC := $(BUILD_LIBHPROF_SRC), \ SRC := $(BUILD_LIBHPROF_SRC), \
LANG := C, \ LANG := C, \
OPTIMIZATION := $(LIBHPROF_OPTIMIZATION), \ OPTIMIZATION := $(LIBHPROF_OPTIMIZATION), \
CFLAGS := $(CFLAGS_JDKLIB) \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) \
$(BUILD_LIBHPROF_CFLAGS), \ $(BUILD_LIBHPROF_CFLAGS), \
CFLAGS_debug := -DHPROF_LOGGING, \ CFLAGS_debug := -DHPROF_LOGGING, \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libhprof/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libhprof/mapfile-vers, \
@ -392,7 +392,7 @@ $(eval $(call SetupNativeCompilation,BUILD_LIBJAVA_CRW_DEMO, \
SRC := $(JDK_TOPDIR)/src/share/demo/jvmti/java_crw_demo, \ SRC := $(JDK_TOPDIR)/src/share/demo/jvmti/java_crw_demo, \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB) \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) \
-I$(JDK_TOPDIR)/src/share/demo/jvmti/java_crw_demo, \ -I$(JDK_TOPDIR)/src/share/demo/jvmti/java_crw_demo, \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjava_crw_demo/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjava_crw_demo/mapfile-vers, \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \
@ -419,7 +419,7 @@ ifndef OPENJDK
SRC := $(JDK_TOPDIR)/src/closed/share/native/oracle/jfr, \ SRC := $(JDK_TOPDIR)/src/closed/share/native/oracle/jfr, \
LANG := C, \ LANG := C, \
OPTIMIZATION := LOW, \ OPTIMIZATION := LOW, \
CFLAGS := $(CFLAGS_JDKLIB) \ CFLAGS := $(CFLAGS_JDKLIB) $(CFLAGS_WARNINGS_ARE_ERRORS) \
-I$(JDK_TOPDIR)/src/closed/share/javavm/export, \ -I$(JDK_TOPDIR)/src/closed/share/javavm/export, \
MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjfr/mapfile-vers, \ MAPFILE := $(JDK_TOPDIR)/make/mapfiles/libjfr/mapfile-vers, \
LDFLAGS := $(LDFLAGS_JDKLIB) \ LDFLAGS := $(LDFLAGS_JDKLIB) \

10
jdk/src/aix/native/sun/tools/attach/AixVirtualMachine.c
View File

@ -1,6 +1,6 @@
/* /*
* Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved.
* Copyright 2013 SAP AG. All rights reserved. * Copyright 2014 SAP AG. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -92,10 +92,10 @@ JNIEXPORT void JNICALL Java_sun_tools_attach_AixVirtualMachine_connect
struct sockaddr_un addr; struct sockaddr_un addr;
int err = 0; int err = 0;
/* added missing structure initialization */ memset(&addr, 0, sizeof(addr));
memset(&addr,0, sizeof(addr));
addr.sun_family = AF_UNIX; addr.sun_family = AF_UNIX;
strcpy(addr.sun_path, p); /* strncpy is safe because addr.sun_path was zero-initialized before. */
strncpy(addr.sun_path, p, sizeof(addr.sun_path) - 1);
/* We must call bind with the actual socketaddr length. This is obligatory for AS400. */ /* We must call bind with the actual socketaddr length. This is obligatory for AS400. */
if (connect(fd, (struct sockaddr*)&addr, SUN_LEN(&addr)) == -1) { if (connect(fd, (struct sockaddr*)&addr, SUN_LEN(&addr)) == -1) {
err = errno; err = errno;

24
jdk/src/bsd/doc/man/ja/jcmd.1 Normal file
View File

@ -0,0 +1,24 @@
." Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jcmd 1 "07 May 2011"
.LP

24
jdk/src/bsd/doc/man/ja/jdeps.1 Normal file
View File

@ -0,0 +1,24 @@
." Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jdeps 1 "07 May 2011"
.LP

24
jdk/src/bsd/doc/man/ja/jjs.1 Normal file
View File

@ -0,0 +1,24 @@
." Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jjs 1 "07 May 2011"
.LP

25
jdk/src/bsd/doc/man/ja/kinit.1
View File

@ -1,25 +0,0 @@
'\" t
.\"
.\" Copyright 2002-2004 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\"
.\"

24
jdk/src/bsd/doc/man/ja/klist.1
View File

@ -1,24 +0,0 @@
'\" t
.\"
.\" Copyright 2002-2004 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\"

24
jdk/src/bsd/doc/man/ja/ktab.1
View File

@ -1,24 +0,0 @@
'\" t
.\"
.\" Copyright 2002-2004 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\"

165
jdk/src/linux/doc/man/ja/appletviewer.1
View File

@ -1,66 +1,105 @@
." Copyright (c) 1995, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: appletviewer
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: 基本ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH appletviewer 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
appletviewer \- Java アプレットビューア .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。 .\"
.LP .pl 99999
.SH "形式" .TH "appletviewer" "1" "2013年11月21日" "JDK 8" "基本ツール"
.LP .\" -----------------------------------------------------------------
.LP .\" * Define some portability stuff
\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ... .\" -----------------------------------------------------------------
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.SH "説明" .\" http://bugs.debian.org/507673
.LP .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注: \f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、 .ie \n(.g .ds Aq \(aq
.na .el .ds Aq '
\f2「アプレットビューアのタグ」\fP @ .\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
appletviewer \- Webブラウザの外側でアプレットを実行します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIappletviewer\fR [\fIoptions\fR] \fIurl\fR\&.\&.\&.
.fi .fi
http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlを参照してください。 .if n \{\
.LP
.LP
\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
.LP
.SH "オプション"
.LP
.RS 3
.TP 3
\-debug
Java デバッガ jdb(1) でアプレットビューアを開始します。これにより、ドキュメント中のアプレットをデバッグすることができます。
.TP 3
\-encoding \ \ encoding name
入力 HTML ファイルのエンコーディング名を指定します。
.TP 3
\-Jjavaoption
文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数にスペースを含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリーの利用に有効です。
.RE .RE
.\}
.PP
\fIoptions\fR
.RS 4
空白で区切られたコマンドライン・オプション。オプションを参照してください。
.RE
.PP
\fIurl\fR
.RS 4
表示するドキュメントまたはリソースの場所。空白で区切られた複数のURLを指定できます。
.RE
.SH "説明"
.PP
\fIappletviewer\fRコマンドは\fIurls\fRに指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。urlsによって参照されたドキュメントが、\fIOBJECT\fR、\fIEMBED\fRまたは\fIAPPLET\fRタグでどのアプレットも参照していない場合、\fIappletviewer\fRコマンドは何も行いません。\fIappletviewer\fRコマンドでサポートされるHTMLタグの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/appletviewertags\&.htmlにある
アプレット・ビューア・タグを参照してください。
.PP
\fIappletviewer\fRコマンドは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。
.PP
\fB注意:\fR
The
\fIappletviewer\fRコマンドは開発専用です。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/aboutCodeSamples\&.htmlにある
サンプル/テスト・アプリケーションおよびコードについてを参照してください。
.SH "オプション"
.PP
\-debug
.RS 4
\fIjdb\fRコマンドを使用してJavaデバッガでアプレット・ビューアを開始して、ドキュメント中のアプレットをデバッグします。
.RE
.PP
\-encoding \fIencoding\-name\fR
.RS 4
入力HTMLファイルのエンコーディング名を指定します。
.RE
.PP
\-J\fIjavaoption\fR
.RS 4
文字列\fIjavaoption\fRは、アプレット・ビューアを実行するJavaインタプリタに1つの引数として渡されます。引数にスペースを含めないでください。複数の引数は、すべてが接頭辞\fI\-J\fRで始まる必要があります。これは、コンパイラの実行環境またはメモリー使用の調整に有効です。
.RE
.PP
.LP .br
.LP 'pl 8.5i
'bp
.LP

171
jdk/src/linux/doc/man/ja/extcheck.1
View File

@ -1,73 +1,108 @@
." Copyright (c) 1998, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: extcheck
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: 基本ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH extcheck 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
extcheck \- jar の競合検出ユーティリティー .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。 .\"
.LP .pl 99999
.SH "形式" .TH "extcheck" "1" "2013年11月21日" "JDK 8" "基本ツール"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
extcheck \- ターゲットのJavaアーカイブ(JAR)ファイルと現在インストールされている拡張機能のJARファイル間のバージョンの競合を検出します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIextcheck\fR [\fIoptions\fR] \fItargetfile\&.jar\fR
.fl
extcheck [ \-verbose ] targetfile.jar
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.SH "説明" .\}
.LP .PP
.LP \fIoptions\fR
\f3extcheck\fP ユーティリティーは、指定された Jar ファイルのタイトルおよびバージョンが Java(TM) 2 SDK にインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティーを使って、バージョンが同じか、より新しい拡張機能がすでにインストールされていないかどうかを調べることができます。 .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
.LP .RE
\f3extcheck\fP ユーティリティーは、targetfile.jar ファイルのマニフェスト内のヘッダー \f2Specification\-title\fP および \f2Specification\-version\fP を、拡張機能ディレクトリ内に現在インストールされている \f2すべての Jar ファイル内の\fP 対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、\f2jre/lib/ext\fP です。\f3extcheck\fP ユーティリティーは、\f2java.lang.Package.isCompatibleWith\fP メソッドと同様の方法でバージョン番号を比較します。 .PP
.LP \fItargetfile\&.jar\fR
.LP .RS 4
競合が検出されない場合のリターンコードは \f20\fP です。 バージョンの競合を検出するために、現在インストールされている拡張機能JARファイルと比較するターゲットJARファイル。
.LP .RE
.LP .SH "説明"
拡張機能ディレクトリ内のいずれかの jar ファイルのマニフェストに、同一の \f2Specification\-title\fP 、および同一またはより新しい \f2Specification\-version\fP 番号がある場合は、ゼロでないエラーコードが返されます。 \f2targetfile.jar\fP のマニフェストに \f2Specification\-title\fP または \f2Specification\-version\fP 属性がない場合も、ゼロでないエラーコードが返されます。 .PP
.LP \fIextcheck\fRコマンドは、指定されたJARファイルのタイトルおよびバージョンがJava SE SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。
.SH "オプション" .PP
.LP \fIextcheck\fRコマンドは、\fItargetfile\&.jar\fRファイルのマニフェスト内のヘッダーSpecification\-titleおよびSpecification\-versionを、拡張機能ディレクトリ内に現在インストールされているすべてのJARファイル内の対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、Oracle Solarisの場合は\fIjre/lib/ext\fR、Windowsの場合は\fI\ejre\elib\eext\fRです。\fIextcheck\fRコマンドは、\fIjava\&.lang\&.Package\&.isCompatibleWith\fRメソッドと同様の方法でバージョン番号を比較します。
.RS 3 .PP
.TP 3 競合が検出されない場合、リターン・コードは0です。
\-verbose .PP
拡張機能ディレクトリ内の Jar ファイルを、チェック時に一覧表示します。また、ターゲット jar ファイルのマニフェストの属性、および競合する jar ファイルについても報告します。 拡張機能ディレクトリ内のいずれかのJARファイルのマニフェストに、同一の\fISpecification\-title\fR、および同一またはより新しい\fISpecification\-version\fR番号がある場合は、ゼロでないエラー・コードが返されます。\fItargetfile\&.jar\fRのマニフェスト・ファイルに\fISpecification\-title\fRまたは\fISpecification\-version\fR属性がない場合も、ゼロでないエラー・コードが返されます。
.TP 3 .SH "オプション"
\-Joption .PP
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。 \-verbose
.RS 4
拡張機能ディレクトリ内のJARファイルを、チェック時に一覧表示します。また、ターゲットJARファイルのマニフェストの属性、および競合するJARファイルについても報告します。
.RE
.PP
\-J\fIoption\fR
.RS 4
Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE .RE
.LP
.SH "´ØÏ¢¹àÌÜ" .SH "´ØÏ¢¹àÌÜ"
.LP .sp
.LP .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jar(1) jar(1)
.LP .RE
.br
'pl 8.5i
'bp

1268
jdk/src/linux/doc/man/ja/idlj.1
View File

File diff suppressed because it is too large Load Diff

1078
jdk/src/linux/doc/man/ja/jar.1
View File

File diff suppressed because it is too large Load Diff

2637
jdk/src/linux/doc/man/ja/jarsigner.1
View File

File diff suppressed because it is too large Load Diff

3030
jdk/src/linux/doc/man/ja/java.1
View File

File diff suppressed because it is too large Load Diff

2629
jdk/src/linux/doc/man/ja/javac.1
View File

File diff suppressed because it is too large Load Diff

7761
jdk/src/linux/doc/man/ja/javadoc.1
View File

File diff suppressed because it is too large Load Diff

345
jdk/src/linux/doc/man/ja/javah.1
View File

@ -1,139 +1,220 @@
." Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: javah
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: 基本ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH javah 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
javah \- C ヘッダーとスタブファイルジェネレータ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。 .\"
.LP .pl 99999
.SH "形式" .TH "javah" "1" "2013年11月21日" "JDK 8" "基本ツール"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
javah \- JavaクラスからCヘッダーとソース・ファイルを生成します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjavah\fR [ \fIoptions\fR ] f\fIully\-qualified\-class\-name \&.\&.\&.\fR
.fl
javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.PP
\fIfully\-qualified\-class\-name\fR
.RS 4
Cヘッダーとソース・ファイルに変換されるクラスの完全修飾された場所。
.RE
.SH "説明" .SH "説明"
.LP .PP
.LP \fIjavah\fRコマンドは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。\fI\&.h\fRファイルは、対応するクラスと一致する配置を持つ\fIstruct\fR定義を含みます。\fIstruct\fRのフィールドは、クラスのインスタンス変数に対応します。
\f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。 .PP
.LP ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\fIjavah\fRコマンドに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方の先頭に付加されます。下線(_)が名前の区切り文字として使用されます。
.LP .PP
ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。 デフォルトでは\fIjavah\fRコマンドは、コマンドラインにリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\fI\-stubs\fRオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\fI\-o\fRオプションを使用してください。
.LP .PP
.LP Java Native Interface (JNI)はヘッダー情報またはスタブ・ファイルを必要としません。\fIjavah\fRコマンドは引き続きJNI形式のネイティブ・メソッドに必要なネイティブ・メソッド関数プロトタイプの生成に使用できます。\fIjavah\fRコマンドはデフォルトでJNI形式の出力を生成し、その結果を\fI\&.h\fRファイルに格納します。
デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。
.LP
.LP
新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-o \fIoutputfile\fR
.TP 3 .RS 4
\-o outputfile コマンドラインにリストされたすべてのクラスに対して、結果のヘッダーまたはソース・ファイルを連結して出力ファイルに格納します。\fI\-o\fRまたは\fI\-d\fRのどちらかのみ使用できます。
コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソースファイルを連結して \f2outputfile\fP に格納します。\f3\-o\fP または \f3\-d\fP のどちらか一方だけが使われます。
.TP 3
\-d directory
\f3javah\fP がヘッダーファイルまたはスタブファイルを保存する、ディレクトリを設定します。\f3\-d\fP または \f3\-o\fP のどちらか一方だけが使われます。
.TP 3
\-stubs
\f3javah\fP が、Java オブジェクトファイルから C 宣言を生成します。
.TP 3
\-verbose
詳細出力を指定し、作成ファイルの状態に関するメッセージを、\f3javah\fP が標準出力に出力します。
.TP 3
\-help
\f3javah\fP の使用法についてのヘルプメッセージを出力します。
.TP 3
\-version
\f3javah\fP のバージョン情報を出力します。
.TP 3
\-jni
JNI 形式のネイティブファイル機能プロトタイプを含む出力ファイルを、\f3javah\fP が作成します。これは標準出力であるため、\f3\-jni\fP の使用はオプションです。
.TP 3
\-classpath path
クラスを探すために \f3javah\fP が使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
.:<your_path>
.fl
\fP
.fi
次に例を示します。
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
.LP
便宜上、 \f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。 \f2*\fP だけから成るクラスパスエントリは、現在のディレクトリ内のすべての JAR ファイルのリストに展開されます。 \f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
.TP 3
\-bootclasspath path
ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-old
古い JDK1.0 形式のヘッダーファイルを生成するように指定します。
.TP 3
\-force
出力ファイルが常に書き込まれるように指定します。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE .RE
.PP
.LP \-d \fIdirectory\fR
.SH "環境変数" .RS 4
.LP \fIjavah\fRがヘッダー・ファイルまたはスタブ・ファイルを保存する、ディレクトリを設定します。\fI\-d\fRまたは\fI\-o\fRのどちらかのみ使用できます。
.RS 3 .RE
.TP 3 .PP
CLASSPATH \-stubs
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割されています。 .RS 4
.nf \fIjavah\fRコマンドが、Javaオブジェクト・ファイルからC宣言を生成します。
\f3 .RE
.fl .PP
.:/home/avh/classes:/usr/local/java/classes \-verbose
.fl .RS 4
\fP 詳細出力を指定し、作成ファイルの状態に関するメッセージを、\fIjavah\fRコマンドが\fI標準出力\fRに出力します。
.fi .RE
.PP
\-help
.RS 4
\fIjavah\fRの使用方法についてのヘルプ・メッセージを出力します。
.RE
.PP
\-version
.RS 4
\fIjavah\fRコマンドのリリース情報を出力します。
.RE
.PP
\-jni
.RS 4
JNI形式のネイティブ・メソッド機能プロトタイプを含む出力ファイルを、\fIjavah\fRコマンドが作成します。これは標準出力であるため、\fI\-jni\fRの使用はオプションです。
.RE
.PP
\-classpath \fIpath\fR
.RS 4
クラスを探すために\fIjavah\fRコマンドが使用するパスを指定します。デフォルトまたは\fICLASSPATH\fR環境変数の設定をオーバーライドします。ディレクトリはOracle Solarisの場合はコロンで、Windowsの場合はセミコロンで区切られます。パスの一般的な形式は次のようになります。
.sp
\fBOracle Solaris\fRの場合:
.sp
\&.:\fIyour\-path\fR
.sp
例:
\fI\&.:/home/avh/classes:/usr/local/java/classes\fR
.sp
\fBWindows\fRの場合:
.sp
\&.;\fIyour\-path\fR
.sp
例:
\fI\&.;C:\eusers\edac\eclasses;C:\etools\ejava\eclasses\fR
.sp
便宜上、*のベース名を含むクラス・パス要素は、\fI\&.jar\fRまたは\fI\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。
.sp
たとえば、ディレクトリ\fImydir\fRに\fIa\&.jar\fRと\fIb\&.JAR\fRが含まれている場合、クラス・パス要素\fImydir/*\fRは\fIA\fR\fI\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fICLASSPATH\fR環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカードの展開は、Java仮想マシン(JVM)の開始前に行われます。Javaプログラムは、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。たとえば、\fISystem\&.getenv("CLASSPATH")\fRをコールして問い合せる場合です。
.RE
.PP
\-bootclasspath \fIpath\fR
.RS 4
ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fIjre\elib\ert\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。
.RE
.PP
\-old
.RS 4
古いJDK 1\&.0形式のヘッダー・ファイルを生成するように指定します。
.RE
.PP
\-force
.RS 4
出力ファイルが常に書き込まれるように指定します。
.RE
.PP
\-J\fIoption\fR
.RS 4
Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.LP .RS 4
javac(1)、java(1)、jdb(1)、javap(1)、javadoc(1) .ie n \{\
.LP \h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javah(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jdb(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javap(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javadoc(1)
.RE
.br
'pl 8.5i
'bp

649
jdk/src/linux/doc/man/ja/javap.1
View File

@ -1,317 +1,344 @@
." Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: javap
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: 基本ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH javap 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
javap \- Java クラスファイル逆アセンブラ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
クラスファイルを逆アセンブルします。 .\"
.LP .pl 99999
.SH "形式" .TH "javap" "1" "2013年11月21日" "JDK 8" "基本ツール"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
javap \- 1つ以上のクラス・ファイルを逆アセンブルします。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&.
.fl
javap [ \fP\f3options\fP\f3 ] classes
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.PP
\fIclassfile\fR
.RS 4
注釈の処理対象となる、空白で区切った1つ以上のクラス(DocFooter\&.classなど)。クラス・パスで検出できるクラスを、ファイル名またはURL(\fIfile:///home/user/myproject/src/DocFooter\&.class\fRなど)で指定できます。
.RE
.SH "説明" .SH "説明"
.LP .PP
.LP \fIjavap\fRコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\fIjavap\fRコマンドは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\fIjavap\fRコマンドはその出力を\fI標準出力\fRに表示します。
\f3javap\fP コマンドは、1 つまたは複数のクラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。
.LP
.RS 3
.TP 3
options
コマンド行オプション。
.TP 3
classes
注釈の処理対象となる 1 つ以上のクラス \f2DocFooter.class\fP など) のリスト (空白区切り)。クラスパスで見つかるクラスは、ファイル名 ( \f2/home/user/myproject/src/DocFooter.class\fP など) または URL ( \f2file:///home/user/myproject/src/DocFooter.class\fP など) で指定できます。
.RE
.LP
.LP
たとえば、次のクラス宣言をコンパイルするとします。
.LP
.nf
\f3
.fl
import java.awt.*;
.fl
import java.applet.*;
.fl
.fl
public class DocFooter extends Applet {
.fl
String date;
.fl
String email;
.fl
.fl
public void init() {
.fl
resize(500,100);
.fl
date = getParameter("LAST_UPDATED");
.fl
email = getParameter("EMAIL");
.fl
}
.fl
.fl
public void paint(Graphics g) {
.fl
g.drawString(date + " by ",100, 15);
.fl
g.drawString(email,290,15);
.fl
}
.fl
}
.fl
\fP
.fi
.LP
.LP
\f3javap DocFooter.class\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
.fl
Compiled from "DocFooter.java"
.fl
public class DocFooter extends java.applet.Applet {
.fl
java.lang.String date;
.fl
java.lang.String email;
.fl
public DocFooter();
.fl
public void init();
.fl
public void paint(java.awt.Graphics);
.fl
}
.fl
\fP
.fi
.LP
.LP
\f3javap \-c DocFooter.class\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
.fl
Compiled from "DocFooter.java"
.fl
public class DocFooter extends java.applet.Applet {
.fl
java.lang.String date;
.fl
.fl
java.lang.String email;
.fl
.fl
public DocFooter();
.fl
Code:
.fl
0: aload_0
.fl
1: invokespecial #1 // Method java/applet/Applet."<init>":()V
.fl
4: return
.fl
.fl
public void init();
.fl
Code:
.fl
0: aload_0
.fl
1: sipush 500
.fl
4: bipush 100
.fl
6: invokevirtual #2 // Method resize:(II)V
.fl
9: aload_0
.fl
10: aload_0
.fl
11: ldc #3 // String LAST_UPDATED
.fl
13: invokevirtual #4 // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
.fl
16: putfield #5 // Field date:Ljava/lang/String;
.fl
19: aload_0
.fl
20: aload_0
.fl
21: ldc #6 // String EMAIL
.fl
23: invokevirtual #4 // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
.fl
26: putfield #7 // Field email:Ljava/lang/String;
.fl
29: return
.fl
.fl
public void paint(java.awt.Graphics);
.fl
Code:
.fl
0: aload_1
.fl
1: new #8 // class java/lang/StringBuilder
.fl
4: dup
.fl
5: invokespecial #9 // Method java/lang/StringBuilder."<init>":()V
.fl
8: aload_0
.fl
9: getfield #5 // Field date:Ljava/lang/String;
.fl
12: invokevirtual #10 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
.fl
15: ldc #11 // String by
.fl
17: invokevirtual #10 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
.fl
20: invokevirtual #12 // Method java/lang/StringBuilder.toString:()Ljava/lang/String;
.fl
23: bipush 100
.fl
25: bipush 15
.fl
27: invokevirtual #13 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
.fl
30: aload_1
.fl
31: aload_0
.fl
32: getfield #7 // Field email:Ljava/lang/String;
.fl
35: sipush 290
.fl
38: bipush 15
.fl
40: invokevirtual #13 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
.fl
43: return
.fl
}
.fl
\fP
.fi
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-help, \-\-help, \-?
.TP 3 .RS 4
\-help \-\-help \-? \fIjavap\fRコマンドについてのヘルプ・メッセージを出力します。
\f3javap\fP のヘルプメッセージを出力します。
.TP 3
\-version
バージョン情報を表示します。
.TP 3
\-l
行番号と局所変数テーブルを表示します。
.TP 3
\-public
public クラスおよびメンバーだけを表示します。
.TP 3
\-protected
protected および public のクラスとメンバーだけを表示します。
.TP 3
\-package
package、protected、および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。
.TP 3
\-private \-p
すべてのクラスとメンバーを表示します。
.TP 3
\-Jflag
ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
.nf
\f3
.fl
javap \-J\-version
.fl
javap \-J\-Djava.security.manager \-J\-Djava.security.policy=MyPolicy MyClassName
.fl
\fP
.fi
.TP 3
\-s
内部の型シグニチャーを出力します。
.TP 3
\-sysinfo
処理中のクラスのシステム情報 (パス、サイズ、日付、MD5 ハッシュ) を表示します。
.TP 3
\-constants
static final 定数を表示します。
.TP 3
\-c
クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
.na
\f2「Java Virtual Machine Specification」\fP @
.fi
http://java.sun.com/docs/books/vmspec/にドキュメント化されています。
.TP 3
\-verbose
メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
.TP 3
\-classpath path
\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。
.TP 3
\-bootclasspath path
ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-extdirs dirs
インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
.RE .RE
.PP
.LP \-version
.SH "関連項目" .RS 4
.LP リリース情報を出力します。
.LP .RE
javac(1)、java(1)、jdb(1)、javah(1)、javadoc(1) .PP
.LP \-l
.RS 4
行番号とローカル変数表を出力します。
.RE
.PP
\-public
.RS 4
publicクラスおよびメンバーのみ表示します。
.RE
.PP
\-protected
.RS 4
protectedおよびpublicのクラスとメンバーのみを表示します。
.RE
.PP
\-private, \-p
.RS 4
すべてのクラスとメンバーを表示します。
.RE
.PP
\-J\fIoption\fR
.RS 4
指定されたオプションをJVMに渡します。次に例を示します。
.sp
.if n \{\
.RS 4
.\}
.nf
javap \-J\-version
javap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName
.fi
.if n \{\
.RE
.\}
JVMオプションの詳細は、コマンドのマニュアルを参照してください。
.RE
.PP
\-s
.RS 4
内部の型シグニチャを出力します。
.RE
.PP
\-sysinfo
.RS 4
処理中のクラスのシステム情報(パス、サイズ、日付、MD5ハッシュ)を表示します。
.RE
.PP
\-constants
.RS 4
\fIstatic final\fR定数を表示します。
.RE
.PP
\-c
.RS 4
クラスの各メソッドのために逆アセンブルされるコード、すなわちJavaバイトコードからなる命令を表示します。
.RE
.PP
\-verbose
.RS 4
メソッドのスタック・サイズ、localsとargumentsの数を出力します。
.RE
.PP
\-classpath \fIpath\fR
.RS 4
クラスを探すために\fIjavap\fRコマンドが使用するパスを指定します。デフォルトまたは\fICLASSPATH\fR環境変数の設定をオーバーライドします。
.RE
.PP
\-bootclasspath \fIpath\fR
.RS 4
ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fIjre/lib/rt\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。
.RE
.PP
\-extdir \fIdirs\fR
.RS 4
インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\fIjava\&.ext\&.dirs\fRです。
.RE
.SH "例"
.PP
次の\fIDocFooter\fRクラスをコンパイルします。
.sp
.if n \{\
.RS 4
.\}
.nf
import java\&.awt\&.*;
import java\&.applet\&.*;
public class DocFooter extends Applet {
String date;
String email;
public void init() {
resize(500,100);
date = getParameter("LAST_UPDATED");
email = getParameter("EMAIL");
}
public void paint(Graphics g) {
g\&.drawString(date + " by ",100, 15);
g\&.drawString(email,290,15);
}
}
.fi
.if n \{\
.RE
.\}
.PP
\fIjavap DocFooter\&.class\fRコマンドからの出力は次を生成します。
.sp
.if n \{\
.RS 4
.\}
.nf
Compiled from "DocFooter\&.java"
public class DocFooter extends java\&.applet\&.Applet {
java\&.lang\&.String date;
java\&.lang\&.String email;
public DocFooter();
public void init();
public void paint(java\&.awt\&.Graphics);
}
.fi
.if n \{\
.RE
.\}
.PP
\fIjavap \-c DocFooter\&.class\fRコマンドからの出力は次を生成します。
.sp
.if n \{\
.RS 4
.\}
.nf
Compiled from "DocFooter\&.java"
public class DocFooter extends java\&.applet\&.Applet {
java\&.lang\&.String date;
java\&.lang\&.String email;
public DocFooter();
Code:
0: aload_0
1: invokespecial #1 // Method
java/applet/Applet\&."<init>":()V
4: return
public void init();
Code:
0: aload_0
1: sipush 500
4: bipush 100
6: invokevirtual #2 // Method resize:(II)V
9: aload_0
10: aload_0
11: ldc #3 // String LAST_UPDATED
13: invokevirtual #4 // Method
getParameter:(Ljava/lang/String;)Ljava/lang/String;
16: putfield #5 // Field date:Ljava/lang/String;
19: aload_0
20: aload_0
21: ldc #6 // String EMAIL
23: invokevirtual #4 // Method
getParameter:(Ljava/lang/String;)Ljava/lang/String;
26: putfield #7 // Field email:Ljava/lang/String;
29: return
public void paint(java\&.awt\&.Graphics);
Code:
0: aload_1
1: new #8 // class java/lang/StringBuilder
4: dup
5: invokespecial #9 // Method
java/lang/StringBuilder\&."<init>":()V
8: aload_0
9: getfield #5 // Field date:Ljava/lang/String;
12: invokevirtual #10 // Method
java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
15: ldc #11 // String by
17: invokevirtual #10 // Method
java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
20: invokevirtual #12 // Method
java/lang/StringBuilder\&.toString:()Ljava/lang/String;
23: bipush 100
25: bipush 15
27: invokevirtual #13 // Method
java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V
30: aload_1
31: aload_0
32: getfield #7 // Field email:Ljava/lang/String;
35: sipush 290
38: bipush 15
40: invokevirtual #13 // Method
java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V
43: return
}
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javac(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jdb(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javah(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javadoc(1)
.RE
.br
'pl 8.5i
'bp

434
jdk/src/linux/doc/man/ja/javaws.1
View File

@ -1,222 +1,232 @@
." Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: javaws
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java Web Startツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH javaws 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
\f2javaws\fP コマンド行 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.SH "名前" .\" questions.
.LP .\"
.LP .pl 99999
\f2javaws\fP \- Java Web Start 起動コマンド .TH "javaws" "1" "2013年11月21日" "JDK 8" "Java Web Startツール"
.LP .\" -----------------------------------------------------------------
.SH "形式" .\" * Define some portability stuff
.LP .\" -----------------------------------------------------------------
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\f2javaws [run\-options] <jnlp>\fP .\" http://bugs.debian.org/507673
.LP .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\f2javaws [control\-options]\fP .ie \n(.g .ds Aq \(aq
.LP .el .ds Aq '
.SH "パラメータ" .\" -----------------------------------------------------------------
.LP .\" * set default formatting
.LP .\" -----------------------------------------------------------------
\f2[run\-options]\fP .\" disable hyphenation
.LP .nh
.LP .\" disable justification (adjust text to left margin only)
コマンド行実行オプション。実行オプションは任意の順序で指定できます。各種オプションについては、下の 「実行オプション」を参照してください。 .ad l
.LP .\" -----------------------------------------------------------------
.LP .\" * MAIN CONTENT STARTS HERE *
\f2<jnlp>\fP .\" -----------------------------------------------------------------
.LP .SH "NAME"
.LP javaws \- Java Web Startを起動します。
JNLP (Java Network Launching Protocol) ファイルのパスまたは URL (Uniform Resource Locator) のどちらかです。 .SH "概要"
.LP .sp
.LP .if n \{\
\f2[control\-options]\fP .RS 4
.LP .\}
.LP .nf
コマンド行制御オプション。制御オプションは任意の順序で指定できます。各種オプションについては、下の 「制御オプション」を参照してください。 \fIjavaws\fR [ \fIrun\-options\fR ] \fIjnlp\fR
.LP .fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjavaws\fR [ \fIcontrol\-options\fR ]
.fi
.if n \{\
.RE
.\}
.PP
\fIrun\-options\fR
.RS 4
コマンドライン\fI実行オプション\fR。\fI実行オプション\fRは任意の順序で指定できます。実行オプションを参照してください。
.RE
.PP
\fIjnlp\fR
.RS 4
JNLP (Java Network Launching Protocol)ファイルのパスまたはURL (Uniform Resource Locator)のどちらか。
.RE
.PP
\fI制御オプション\fR
.RS 4
コマンドライン\fI制御オプション\fR。\fI制御オプション\fRは任意の順序で指定できます。制御オプションを参照してください。
.RE
.SH "説明" .SH "説明"
.LP .PP
.LP \fB注意:\fR
\f2javaws\fP コマンドは、JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動します。Java Web Start は、ネットワーク上で動作する Java アプリケーションまたはアプレットを起動します。 \fIjavaws\fRコマンドは、Oracle Solarisでは使用できません。
.LP .PP
.LP \fIjavaws\fRコマンドは、JNLPのリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションおよびアプレットを起動します。
JNLP ファイルが指定された場合、 \f2javaws\fP は、その JNLP ファイルで指定された Java アプリケーション/アプレットを起動します。 .PP
.LP JNLPファイルが指定されると、\fIjavaws\fRコマンドはJNLPファイルで指定したJavaアプリケーションまたはアプレットを起動します。
.LP .PP
\f2javaws\fP 起動ツールには、現在のリリースでサポートされている 1 組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 \fIjavaws\fR起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。
.LP
.SH "実行オプション" .SH "実行オプション"
.LP .PP
.LP \-offline
\f2\-offline\fP .RS 4
.LP Java Web Startをオフライン・モードで実行します。
.LP .RE
Java Web Start をオフラインモードで実行します。 .PP
.LP \-Xnosplash
.LP .RS 4
\f2\-Xnosplash\fP
.LP
.LP
初期スプラッシュ画面を表示しません。 初期スプラッシュ画面を表示しません。
.LP .RE
.LP .PP
\f2\-open <arguments>\fP \-open \fIarguments\fR
.LP .RS 4
.LP このオプションを指定すると、JNLPファイル内の引数が\fI\-open\fR
このオプションを指定すると、JNLP ファイル内の引数が \f2\-open <arguments>\fP に置き換わります。 \fIarguments\fRに置き換わります。
.LP .RE
.LP .PP
\f2\-print <arguments>\fP \-print \fIarguments\fR
.LP .RS 4
.LP このオプションを指定すると、JNLPファイル内の引数が\fI\-print\fR
このオプションを指定すると、JNLP ファイル内の引数が \f2\-print <arguments>\fP に置き換わります。 \fIarguments\fRに置き換わります。
.LP .RE
.LP .PP
\f2\-online\fP \-online
.LP .RS 4
.LP オンライン・モードを使用します。これは、デフォルトの動作です。
オンラインモードを使用します (デフォルトの動作)。 .RE
.LP .PP
.LP \-wait
\f2\-wait\fP .RS 4
.LP \fIjavaws\fRプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。
.LP .RE
このオプションを指定した場合、 \f2javaws\fP プロセスは、アプリケーションが終了するまで終了しません。Windows プラットフォーム上では、このオプションは説明したとおりに機能しません。 .PP
.LP \-verbose
.LP .RS 4
\f2\-verbose\fP
.LP
.LP
追加の出力を表示します。 追加の出力を表示します。
.LP .RE
.LP .PP
\f2\-J<option>\fP \-J\fIoption\fR
.LP .RS 4
.LP Java仮想マシンにoptionを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
vm にオプションを補います。 .RE
.LP .PP
.LP \-system
\f2\-system\fP .RS 4
.LP アプリケーションをシステム・キャッシュのみから実行します。
.LP .RE
アプリケーションをシステムキャッシュからのみ実行します。
.LP
.SH "制御オプション" .SH "制御オプション"
.LP .PP
.LP \-viewer
\f2\-viewer\fP .RS 4
.LP Javaコントロール・パネルでキャッシュ・ビューアを表示します。
.LP .RE
Java コントロールパネルでキャッシュビューアを表示します。 .PP
.LP \-clearcache
.LP .RS 4
\f2\-clearcache\fP
.LP
.LP
インストールされていないすべてのアプリケーションをキャッシュから削除します。 インストールされていないすべてのアプリケーションをキャッシュから削除します。
.LP .RE
.LP .PP
\f2\-userConfig <property name>\fP \-userConfig \fIproperty\-name\fR
.LP .RS 4
.LP 指定されたデプロイメント・プロパティをクリアします。
指定された配備プロパティーをクリアします。 .RE
.LP .PP
.LP \-userConfig \fIproperty\-name property\-value\fR
\f2\-userConfig <property name> <property value>\fP .RS 4
.LP 指定されたデプロイメント・プロパティを指定された値に設定します。
.LP .RE
指定された配備プロパティーを指定された値に設定します。 .PP
.LP \-uninstall
.LP .RS 4
\f2\-uninstall\fP
.LP
.LP
キャッシュからすべてのアプリケーションを削除します。 キャッシュからすべてのアプリケーションを削除します。
.LP .RE
.LP .PP
\f2\-uninstall <jnlp>\fP \-uninstall \fIjnlp\fR
.LP .RS 4
.LP
キャッシュからアプリケーションを削除します。 キャッシュからアプリケーションを削除します。
.LP .RE
.LP .PP
\f2\-import [import\-options] <jnlp>\fP \-print \fIimport\-options \fRjnlp
.LP .RS 4
.LP
キャッシュにアプリケーションをインポートします。 キャッシュにアプリケーションをインポートします。
.LP .RE
.SH "インポートオプション" .SH "インポート・オプション"
.LP .PP
.LP \-silent
\f2\-silent\fP .RS 4
.LP サイレント・モードでインポートします(ユーザー・インタフェースは表示されません)。
.LP .RE
サイレントモードでインポートします (UI は表示されません)。 .PP
.LP \-system
.LP .RS 4
\f2\-system\fP システム・キャッシュにアプリケーションをインポートします。
.LP .RE
.LP .PP
システムキャッシュにアプリケーションをインポートします。 \-codebase \fIurl\fR
.LP .RS 4
.LP 指定したコードベースからリソースを取得します。
\f2\-codebase <url>\fP .RE
.LP .PP
.LP \-shortcut
任意の codebase からリソースを取得します。 .RS 4
.LP ユーザーがプロンプトを受け入れればショートカットをインストールします。このオプションは、
.LP \fI\-silent\fRオプションも使用しないと効果がありません。
\f2\-shortcut\fP .RE
.LP .PP
.LP \-association
ユーザー許容プロンプトのようにショートカットをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。 .RS 4
.LP ユーザーがプロンプトを受け入れればアソシエーションをインストールします。このオプションは、
.LP \fI\-silent\fRオプションも使用しないと効果がありません。
\f2\-association\fP .RE
.LP .PP
.LP \fB注意:\fR\fIjavaws \-shortcut \-uninstall\fR
ユーザー許容プロンプトのように関連付けをインストールします。このオプションは、 \f2\-silent\fP オプションも使用しないと効果がありません。
.LP
.SH "ファイル" .SH "ファイル"
.LP .PP
.LP ユーザーおよびシステム・キャッシュならびにdeployment\&.propertiesファイルの詳細は、構成ファイルおよびプロパティのデプロイメント
ユーザーキャッシュ、システムキャッシュ、および deployment.properties ファイルについては、 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment\-guide/properties\&.html)を参照してください
.na .SH "関連項目"
\f2システムレベルおよびユーザーレベルのプロパティー\fP @ .sp
.fi .RS 4
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。 .ie n \{\
.LP \h'-04'\(bu\h'+03'\c
.SH "詳細情報" .\}
.LP .el \{\
.LP .sp -1
Java Web Start の詳細は、 .IP \(bu 2.3
.na .\}
\f2「Java Web Start」\fP @ Java Web Start
.fi (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javaws/index\&.html)
http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlを参照してください。 .RE
.LP .br
'pl 8.5i
'bp

154
jdk/src/linux/doc/man/ja/jcmd.1 Normal file
View File

@ -0,0 +1,154 @@
'\" t
.\" Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
.\" Title: jcmd
.\" Language: English
.\" Date: 2013年11月21日
.\" SectDesc: トラブルシューティング・ツール
.\" Software: JDK 8
.\" Arch: 汎用
.\"
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.pl 99999
.TH "jcmd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jcmd \- 実行中のJava仮想マシン(JVM)に診断コマンド・リクエストを送信します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjcmd\fR [\fI\-l\fR|\fI\-h\fR|\fI\-help\fR]
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fIPerfCounter\&.print\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fI\-f\fR \fIfilename\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR]
.fi
.if n \{\
.RE
.\}
.SH "説明"
.PP
\fIjcmd\fRユーティリティは、JVMに診断コマンド・リクエストを送信するために使用されます。これはJVMが稼働しているのと同じマシンで使用し、JVMの起動に使用したものと同じ有効ユーザーおよびグループ識別子を持っている必要があります。
.PP
\fB注意:\fR
リモート・マシンから、または別の識別子で診断コマンドを起動するには、\fIcom\&.sun\&.management\&.DiagnosticCommandMBean\fRインタフェースを使用できます。\fIDiagnosticCommandMBean\fRインタフェースの詳細は、http://download\&.java\&.net/jdk8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.htmlにあるAPIドキュメントを参照してください。
.PP
\fIjcmd\fRを引数なしまたは\fI\- l\fRオプションを指定して実行した場合は、実行中のJavaプロセス識別子のリストが、メイン・クラスおよびプロセスの起動に使用されたコマンドライン引数とともに出力されます。\fI\-h\fRまたは\fI\-help\fRオプションを指定して\fIjcmd\fRを実行すると、ツールのヘルプ・メッセージが出力されます。
.PP
プロセス識別子(\fIpid\fR)またはメイン・クラス(\fImain\-class\fR)を最初の引数として指定した場合、\fIjcmd\fRは、識別子を指定した場合はJavaプロセスに、メイン・クラスの名前を指定した場合はすべてのJavaプロセスに診断コマンド・リクエストを送信します。プロセス識別子として\fI0\fRを指定して、すべての使用可能なJavaプロセスに診断コマンド・リクエストを送信することもできます。診断コマンド・リクエストとして、次のいずれかを使用します。
.PP
Perfcounter\&.print
.RS 4
指定したJavaプロセスで使用可能なパフォーマンス・カウンタが出力されます。パフォーマンス・カウンタのリストはJavaプロセスによって異なる場合があります。
.RE
.PP
\-f \fIfilename\fR
.RS 4
診断コマンドを読み取り、指定したJavaプロセスに送信するファイルの名前。\fI\-f\fRオプションでのみ使用します。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fI#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fIstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。
.RE
.PP
\fIcommand\fR [\fIarguments\fR]
.RS 4
指定されたJavaプロセスに送信するコマンド。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\fIhelp\fRコマンドを送信すれば表示されます。各診断コマンドに独自の引数セットがあります。コマンドの説明、構文および使用可能な引数のリストを表示するには、\fIhelp\fRコマンドの引数としてコマンド名を使用します。
.sp
\fB注意:\fR
引数にスペースが含まれている場合は、一重引用符または二重引用符(\fI\*(Aq\fRまたは\fI"\fR)で囲む必要があります。加えて、オペレーティング・システム・シェルが引用符を処理しないように、バックスラッシュ(\fI\e\fR)で一重引用符または二重引用符をエスケープする必要があります。または、これらの引数を一重引用符で囲んでから、二重引用符で囲むこともできます(または二重引用符で囲んでから、一重引用符で囲む)。
.RE
.SH "オプション"
.PP
各オプションは互いに排他的です。
.PP
\-f \fIfilename\fR
.RS 4
指定されたファイルからコマンドを読み取ります。このオプションは、最初の引数としてプロセス識別子またはメイン・クラスを指定する場合にのみ使用できます。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fI#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fIstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。
.RE
.PP
\-h, \-help
.RS 4
ヘルプ・メッセージが出力されます。
.RE
.PP
\-l
.RS 4
実行中のJavaプロセス識別子のリストをメイン・クラスおよびコマンドライン引数とともに出力します。
.RE
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.br
'pl 8.5i
'bp

295
jdk/src/linux/doc/man/ja/jconsole.1
View File

@ -1,157 +1,156 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jconsole
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jconsole 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jconsole \- Java 監視および管理コンソール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jconsole" "1" "2013年11月21日" "JDK 8" "Javaトラブルシューティング、プロファイリング、モニタリン"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
関連項目 .\" -----------------------------------------------------------------
.RE .\" disable hyphenation
.nh
.LP .\" disable justification (adjust text to left margin only)
.SH "形式" .ad l
.LP .\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jconsole \- Javaアプリケーションを監視および管理するためのグラフィカル・コンソールを開始します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ]
.fl
\fP\f3jconsole\fP [ \f2options\fP ] [ connection ... ]
.fl
.fl
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.RS 3
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
connection = pid | host:port | jmxUrl
.RS 3
.TP 2
o
\f2pid\fPローカルの Java VM のプロセス ID。Java VM は、jconsole を実行しているユーザー ID と同じユーザー ID を使用して実行する必要があります。詳細については、
.na
\f2「JMX 監視および管理」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
.TP 2
o
\f2host\fP:\f2port\fP Java VM が実行しているホストシステムの名前と、JVM を起動したときにシステムプロパティー \f2com.sun.management.jmxremote.port\fP で指定したポート番号。詳細については、
.na
\f2「JMX 監視および管理」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
.TP 2
o
\f2jmxUrl\fP 接続先の JMX エージェントのアドレス。これについては、
.na
\f2JMXServiceURL\fP @
.fi
http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html を参照してください。
.RE .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE .RE
.PP
.LP connection = \fIpid\fR | \fIhost\fR:\fIport\fR | \fIjmxURL\fR
.SH " 説明" .RS 4
.LP \fIpid\fR値はローカルのJava仮想マシン(JVM)のプロセスIDです。JVMは\fIjconsole\fRコマンドを実行しているユーザーIDと同じユーザーIDで実行する必要があります。\fIhost:port\fR値はJVMが動作しているホスト・システムの名前と、JVMが開始したときにシステム・プロパティ\fIcom\&.sun\&.management\&.jmxremote\&.port\fRで指定したポート番号です。\fIjmxUrl\fR値は、JMXServiceURLで記述されている、接続されるJMXエージェントのアドレスです。
.LP .sp
\f3jconsole\fP コマンドは、ローカルマシンまたはリモートマシン上の Java アプリケーションと仮想マシンの監視と管理を行うグラフィカルコンソールツールを起動します。 \fIconnection\fRパラメータの詳細は、JMXテクノロジを使用したモニタリングおよび管理
.LP (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html)を参照してください
.LP .sp
Windows 上では、\f3jconsole\fP はコンソールウィンドウと関連付けられていません。ただし、なんらかの理由で \f3jconsole\fP コマンドが失敗すると、エラー情報を示すダイアログボックスが表示されます。 \fIJMXServiceURL\fRクラスの説明(
.LP http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html)も参照してください
.RE
.SH "説明"
.PP
\fIjconsole\fRコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンの監視と管理を行うグラフィカル・コンソール・ツールを起動します。
.PP
Windows上では、\fIjconsole\fRコマンドはコンソール・ウィンドウと関連付けられていません。ただし、\fIjconsole\fRコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-interval\fI=n\fR
.TP 3 .RS 4
\-interval=n 更新間隔を\fIn\fR秒に設定します(デフォルトは4秒)。
更新間隔を \f2n\fP 秒に設定します (デフォルトは 4 秒)。 .RE
.TP 3 .PP
\-notile \-notile
最初にウィンドウをタイリングしません (複数の接続のため)。 .RS 4
.TP 3 最初にウィンドウをタイリングしません(複数接続の場合)。
\-pluginpath plugins .RE
JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。 .PP
.br \-pluginpath \fIplugins\fR
.nf .RS 4
\f3 \fIJConsole\fRプラグインを検索するディレクトリまたはJARファイルのリストを指定します。\fIplugins\fRパスには\fIMETA\-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRという名前のプロバイダ構成ファイルを含んでいる必要があり、これにはプラグインごとに1行が含まれています。その行は\fIcom\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRクラスを実装しているクラスの完全修飾クラス名を指定します。
.fl .RE
META\-INF/services/com.sun.tools.jconsole.JConsolePlugin .PP
.fl \-version
\fP .RS 4
.fi リリース情報を表示して終了します。
.LP .RE
これには、 .PP
.na \-help
\f2com.sun.tools.jconsole.JConsolePlugin\fP @ .RS 4
.fi ヘルプ・メッセージを表示します。
http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。 .RE
.TP 3 .PP
\-version \-J\fIflag\fR
バージョン情報を出力して終了します。 .RS 4
.TP 3 \fIjconsole\fRコマンドを実行したJVMに\fIflag\fRを渡します。
\-help
ヘルプメッセージを出力して終了します。
.TP 3
\-J<flag>
jconsole が実行されている Java 仮想マシンに <flag> を渡します。
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.RS 3 .RS 4
.TP 2 .ie n \{\
o \h'-04'\(bu\h'+03'\c
.na .\}
\f2JConsole の使用\fP @ .el \{\
.fi .sp -1
http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html .IP \(bu 2.3
.TP 2 .\}
o JConsoleの使用
.na (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/jconsole\&.html)
\f2「Java プラットフォームの監視および管理」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
JMXテクノロジを使用したモニタリングおよび管理
.LP (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIJMXServiceURL\fRクラスの説明(
http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html)
.RE
.br
'pl 8.5i
'bp

670
jdk/src/linux/doc/man/ja/jdb.1
View File

@ -1,326 +1,382 @@
." Copyright (c) 1995, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jdb
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: 基本ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jdb 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jdb \- Java デバッガ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。 .\"
.LP .pl 99999
.SH "形式" .TH "jdb" "1" "2013年11月21日" "JDK 8" "基本ツール"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jdb \- Javaプラットフォーム・プログラムの不具合を検出および修正します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjdb\fR [\fIoptions\fR] [\fIclassname\fR] [\fIarguments\fR]
.fl
\fP\f3jdb\fP [ options ] [ class ] [ arguments ]
.fl
.fi .fi
.if n \{\
.LP
.RS 3
.TP 3
options
次に示すコマンド行オプション
.TP 3
class
デバッグを開始するクラスの名前
.TP 3
arguments
class の \f2main()\fP メソッドに渡す \f2引数\fP
.RE .RE
.\}
.LP .PP
.SH " 説明" \fIoptions\fR
.LP .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
Java デバッガ \f3jdb\fP は、Java クラス用の簡単なコマンド行デバッガです。 .RE
.na .PP
\f2Java Platform Debugger Architecture\fP @ \fIclass\fRname
.fi .RS 4
http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html を視覚的に実行し、ローカルまたはリモートの Java Virtual Machine の検査とデバッグを行うことができます。 デバッグするメイン・クラスの名前。
.LP .RE
.SS .PP
jdb セッションの開始 \fIarguments\fR
.LP .RS 4
.LP classの\fImain()\fRメソッドに渡す引数。
jdb セッションを開始するにはさまざまな方法があります。もっとも頻繁に使われるのは、デバッグするアプリケーションのメインクラスを使用して、\f3jdb\fP から新しい Java 仮想マシン (VM) を起動する方法です。コマンド行で、\f3java\fP の代わりに \f3jdb\fP コマンドを入力します。たとえば、アプリケーションのメインクラスが MyClass の場合は、JDB 環境でデバッグするときに次のコマンドを使用します。 .RE
.LP .SH "説明"
.PP
Javaデバッガ(JDB)は、Javaクラス用の簡単なコマンドライン・デバッガです。\fIjdb\fRコマンドとそのオプションはJDBを呼び出します。\fIjdb\fRコマンドは、JDBA (Java Platform Debugger Architecture)を視覚的に実行し、ローカルまたはリモートのJava仮想マシン(JVM)の検査とデバッグを行うことができます。Java Platform Debugger Architecture (JDBA)
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jpda/index\&.html)を参照してください。
.SS "JDBセッションの開始"
.PP
JDBセッションを開始するには様々な方法があります。最も頻繁に使用されるのは、デバッグするアプリケーションのメイン・クラスを使用して、JDBから新しいJVMを起動する方法です。コマンドラインで、\fIjava\fRコマンドのかわりに\fIjdb\fRコマンドを入力します。たとえば、アプリケーションのメイン・クラスが\fIMyClass\fRの場合は、JDB環境でデバッグするときに次のコマンドを使用します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 jdb MyClass
.fl
% jdb MyClass
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
この方法で起動すると、\f3jdb\fP は、指定されたパラメータを使って 2 つ目の Java VM を呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前に VM を停止させます。 .PP
.LP この方法で起動すると、\fIjdb\fRコマンドは、指定されたパラメータを使用して2つ目のJVMを呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前にJVMを停止させます。
.LP .PP
\f3jdb\fP のもう 1 つの使用方法は、すでに起動している Java VM に jdb を接続することです。jdb が接続する VM を、その実行中に起動するための構文を次に示します。これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。 \fIjdb\fRコマンドのもう1つの使用方法は、すでに実行中のJVMにjdbを接続することです。\fIjdb\fRコマンドが接続するVMを、その実行中に起動するための構文を次に示します。これは、インプロセス・デバッグ用ライブラリをロードし、接続の種類を指定します。
.LP .sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 java \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n MyClass
.fl
\-agentlib:jdwp=transport=dt_socket,server=y,suspend=n
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
たとえば、次のコマンドは、MyClass アプリケーションを実行して、\f3jdb\fP があとでそのアプリケーションに接続できるようにします。 .PP
.LP 次のコマンドを使用して、\fIjdb\fRコマンドをJVMに接続できます。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 jdb \-attach 8000
.fl
% java \-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n MyClass
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
次のコマンドを使用して、\f3jdb\fP を VM に接続できます。 .PP
.LP この場合、\fIjdb\fRコマンドは新しいJVMを起動するかわりに既存のJVMに接続されるため、\fIjdb\fRコマンドラインに\fIMyClass\fR引数は指定しません。
.PP
デバッガをJVMに接続するには他にも様々な方法があり、すべて\fIjdb\fRコマンドでサポートされています。接続オプションについては、Java Platform Debugger Architectureのドキュメントを参照してください。
.SS "基本jdbコマンド"
.PP
基本的な\fIjdb\fRコマンドの一覧を示します。JDBがサポートするコマンドはこれ以外にもあり、それらは\fI\-help\fRオプションを使用して表示できます。
.PP
helpまたは?
.RS 4
\fIhelp\fRまたは\fI?\fRコマンドは、認識されたコマンドのリストに簡潔な説明を付けて表示します。
.RE
.PP
run
.RS 4
JDBを起動してブレークポイントを設定したあとに、\fIrun\fRコマンドを使用して、デバッグするアプリケーションの実行を開始できます。\fIrun\fRコマンドは、既存のVMに接続している場合とは異なり、デバッグするアプリケーションが\fIjdb\fRから起動したときにのみ使用できます。
.RE
.PP
cont
.RS 4
ブレークポイント、例外、またはステップ実行の後で、デバッグするアプリケーションの実行を継続します。
.RE
.PP
print
.RS 4
Javaオブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトの詳細を取得する方法を探すには、dumpコマンドを参照してください。
.sp
\fB注意:\fR
ローカル変数を表示するには、含んでいるクラスが\fIjavac \-g\fRオプションを使用してコンパイルされている必要があります。
.sp
\fIprint\fRコマンドは、次に示すような、メソッド呼出しを使用したものなど、多くの簡単なJava式をサポートします。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 print MyClass\&.myStaticField
.fl print myObj\&.myInstanceField
% jdb \-attach 8000 print i + j + k (i, j, k are primities and either fields or local variables)
.fl print myObj\&.myMethod() (if myMethod returns a non\-null)
\fP print new java\&.lang\&.String("Hello")\&.length()
.fi .fi
.if n \{\
.LP
.LP
この場合、\f3jdb\fP は新しい VM を起動する代わりに既存の VM に接続されるため、\f3jdb\fP コマンド行には「MyClass」は指定しません。
.LP
.LP
デバッガを VM に接続するにはほかにもさまざまな方法があり、すべて \f3jdb\fP でサポートされています。接続オプションについては、Java Platform Debugger Architecture の
.na
\f2ドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
.na
\f21.4.2 のドキュメント\fP @
.fi
http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlを参照してください。
.LP
.SS
基本 jdb コマンド
.LP
.LP
基本的な \f3jdb\fP コマンドの一覧を示します。Java デバッガがサポートするコマンドはこれ以外にもあり、それらは \f3jdb\fP の \f2help\fP コマンドを使用して表示できます。
.LP
.RS 3
.TP 3
help または ?
もっとも重要な \f3jdb\fP コマンド \f2help\fP は、認識されたコマンドのリストに簡潔な説明を付けて表示します。
.TP 3
run
\f3jdb\fP を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、デバッグするアプリケーションの実行を開始できます。このコマンドは、既存の VM に接続している場合とは異なり、デバッグするアプリケーションが \f3jdb\fP から起動したときにだけ使用できます。
.TP 3
cont
ブレークポイント、例外、またはステップ実行のあとで、デバッグするアプリケーションの実行を継続します。
.TP 3
print
Java オブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトについては、以降の \f2dump\fP コマンドの説明を参照してください。
.LP
\f2注: 局所変数を表示するには、その変数を含むクラスが \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP オプションでコンパイルされている必要があります。
.LP
\f2print\fP では、メソッドの呼び出しを含む多数の簡単な Java 式がサポートされています。次に例を示します。
.RS 3
.TP 2
o
\f2print MyClass.myStaticField\fP
.TP 2
o
\f2print myObj.myInstanceField\fP
.TP 2
o
\f2print i + j + k\fP (i、j、および k はプリミティブであり、フィールドまたは局所変数のいずれか)
.TP 2
o
\f2print myObj.myMethod()\fP (myMethod が null 以外を返す場合)
.TP 2
o
\f2print new java.lang.String("Hello").length()\fP
.RE .RE
.TP 3 .\}
dump .RE
プリミティブ値の場合には、このコマンドは \f2print\fP と同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。static フィールドと instance フィールドが出力されます。 .PP
.LP dump
\f2dump\fP コマンドでは、\f2print\fP コマンドと同じ式がサポートされます。 .RS 4
.TP 3 プリミティブ値の場合、\fIdump\fRコマンドは\fIprint\fRコマンドと同一です。オブジェクトの場合、\fIdump\fRコマンドでは、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。\fIdump\fRコマンドでは、\fIprint\fRコマンドと同じ式がサポートされます。
threads .RE
現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、およびほかのコマンドに使用できるインデックスが出力されます。次に例を示します。 .PP
threads
.RS 4
現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。この例では、スレッド・インデックスは4であり、スレッドは\fIjava\&.lang\&.Thread\fRのインスタンスで、スレッドの名前は\fImain\fRであり、現在実行中です。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 4\&. (java\&.lang\&.Thread)0x1 main running
.fl
4. (java.lang.Thread)0x1 main running
.fl
\fP
.fi .fi
この例では、スレッドインデックスは 4 であり、スレッドは java.lang.Thread のインスタンスです。スレッドの名前は「main」であり、現在実行中です。 .if n \{\
.TP 3
thread
現在のスレッドにするスレッドを選択します。多くの \f3jdb\fP コマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fP コマンドで説明したスレッドインデックスとともに指定します。
.TP 3
where
\f2引数を指定しないで\fP where を実行すると、現在のスレッドのスタックがダンプされます。 \f2where all\fP コマンドは、現在のスレッドグループにあるスレッドのスタックをすべてダンプします。 \f2where\fP \f2threadindex\fP は、指定されたスレッドのスタックをダンプします。
.LP
現在のスレッドが (ブレークポイントか \f2suspend\fP コマンドによって) 中断している場合は、局所変数とフィールドは \f2print\fP コマンドと \f2dump\fP コマンドで表示できます。\f2up\fP コマンドと \f2down\fP コマンドで、どのスタックフレームをカレントにするかを選ぶことができます。
.RE .RE
.\}
.LP
.SS
ブレークポイント
.LP
.LP
ブレークポイントは、行番号またはメソッドの最初の命令で \f3jdb\fP に設定できます。次に例を示します。
.LP
.RS 3
.TP 2
o
\f2stop at MyClass:22\fP (MyClass が含まれるソースファイルの 22 行目の最初の命令にブレークポイントを設定)
.TP 2
o
\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP メソッドの最初にブレークポイントを設定)
.TP 2
o
\f2stop in MyClass.<init>\fP (<init> は MyClass コンストラクタを識別)
.TP 2
o
\f2stop in MyClass.<clinit>\fP (<clinit> は MyClass の静的初期化コードを識別)
.RE .RE
.PP
.LP thread
.LP .RS 4
メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにしなければなりません。たとえば、「\f2MyClass.myMethod(int,java.lang.String)\fP」または「\f2MyClass.myMethod()\fP」と指定します。 現在のスレッドにするスレッドを選択します。多くの\fIjdb\fRコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、threadsコマンドで説明したスレッド・インデックスとともに指定します。
.LP
.LP
\f2clear\fP コマンドは、「\f2clear\ MyClass:45\fP」のような構文を使用してブレークポイントを削除します。\f2clear\fP を使用するか、引数を指定しないでコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\f2cont\fP コマンドは実行を継続します。
.LP
.SS
ステップ実行
.LP
.LP
\f2step\fP コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fP コマンドは、現在のスタックフレームの次の行を実行します。
.LP
.SS
例外
.LP
.LP
スローしているスレッドの呼び出しスタック上のどこにも catch 文がない場合に例外が発生すると、VM は通常、例外トレースを出力して終了します。ただし、\f3jdb\fP 環境で実行している場合は、例外が発生すると \f3jdb\fP に制御が戻ります。次に、\f3jdb\fP を使用して例外の原因を診断します。
.LP
.LP
たとえば、「\f2catch java.io.FileNotFoundException\fP」または「\f2catch mypackage.BigTroubleException\fP」のように \f2catch\fP コマンドを使用すると、デバッグされたアプリケーションは、ほかの例外がスローされたときに停止します。例外が特定のクラス (またはサブクラス) のインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。
.LP
.LP
\f2ignore\fP コマンドを使うと、以前の \f2catch\fP コマンドの効果が無効になります。
.LP
.LP
\f2注: \fP\f2ignore\fP コマンドでは、デバッグされる VM は例外を無視せず、デバッガだけが例外を無視します。
.LP
.SH "コマンド行オプション"
.LP
.LP
コマンド行で Java アプリケーション起動ツールの代わりに \f3jdb\fP を使用する場合、\f3jdb\fP は、\f2\-D\fP、\f2\-classpath\fP、\f2\-X<option>\fP など、java コマンドと同じ数のオプションを受け入れます。
.LP
.LP
\f3jdb\fP は、そのほかに次のオプションを受け入れます。
.LP
.RS 3
.TP 3
\-help
ヘルプメッセージを表示します。
.TP 3
\-sourcepath <dir1:dir2:...>
指定されたパスを使用して、ソースファイルを検索します。このオプションが指定されていない場合は、デフォルトパスの「.」が使われます。
.TP 3
\-attach <address>
デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続します。
.TP 3
\-listen <address>
実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
.TP 3
\-listenany
実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
.TP 3
\-launch
デバッグするアプリケーションを jdb の起動後ただちに起動します。このオプションによって、\f2run\fP コマンドを使用する必要がなくなります。デバッグするアプリケーションは、起動後、初期アプリケーションクラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\f2cont\fP を使用して実行を継続できます。
.TP 3
\-listconnectors
この VM で利用できるコネクタを一覧表示します。
.TP 3
\-connect <connector\-name>:<name1>=<value1>,...
一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
.TP 3
\-dbgtrace [flags]
jdb のデバッグ情報を出力します。
.TP 3
\-tclient
Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
.TP 3
\-tserver
Java HotSpot(tm) VM (サーバー) 内でアプリケーションを実行します。
.TP 3
\-Joption
jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される)。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE .RE
.PP
.LP where
.LP .RS 4
デバッガとデバッグを行う VM を接続するための代替機構に対して、その他のオプションがサポートされています。その他の接続オプションについては、Java Platform Debugger Architecture の 引数を指定しないで\fIwhere\fRコマンドを実行すると、現在のスレッドのスタックがダンプされます。\fIwhere\fR
.na \fIall\fRコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\fIwhere\fR
\f2ドキュメント\fP @ \fIthreadindex\fRコマンドは、指定されたスレッドのスタックをダンプします。
.fi .sp
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。 現在のスレッドが(ブレークポイントか\fIsuspend\fRコマンドによって)中断している場合は、ローカル変数とフィールドは\fIprint\fRコマンドと\fIdump\fRコマンドで表示できます。\fIup\fRコマンドと\fIdown\fRコマンドで、どのスタック・フレームを現在のスタック・フレームにするかを選ぶことができます。
.LP .RE
.SS .SS "ブレークポイント"
デバッグ対象のプロセスに転送されるオプション .PP
.LP ブレークポイントは、行番号またはメソッドの最初の命令でJDBに設定できます。次に例を示します。
.RS 3 .sp
.TP 3 .RS 4
\-v \-verbose[:class|gc|jni] .ie n \{\
冗長モードにします。 \h'-04'\(bu\h'+03'\c
.TP 3 .\}
\-D<name>=<value> .el \{\
システムプロパティーを設定します。 .sp -1
.TP 3 .IP \(bu 2.3
\-classpath <directories separated by ":"> .\}
クラスを検索するディレクトリを一覧表示します。 コマンド\fIstop at MyClass:22\fRは、\fIMyClass\fRが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定します。
.TP 3 .RE
\-X<option> .sp
非標準ターゲット VM オプションです。 .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンド\fIstop in java\&.lang\&.String\&.length\fRは、メソッド\fIjava\&.lang\&.String\&.length\fRの先頭にブレークポイントを設定します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンド\fIstop in MyClass\&.<clinit>\fRは、\fI<clinit>\fRを使用して\fIMyClass\fRの静的初期化コードを特定します。
.RE
.PP
メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにする必要があります。たとえば、\fIMyClass\&.myMethod(int,java\&.lang\&.String)\fRまたは\fIMyClass\&.myMethod()\fRと指定します。
.PP
\fIclear\fRコマンドは、\fIclear MyClass:45\fRのような構文を使用してブレークポイントを削除します。\fIclear\fRを使用するか、引数を指定しないで\fIstop\fRコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\fIcont\fRコマンドは実行を継続します。
.SS "ステップ実行"
.PP
\fIstep\fRコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\fInext\fRコマンドは、現在のスタック・フレームの次の行を実行します。
.SS "例外"
.PP
スローしているスレッドの呼出しスタック上のどこにも\fIcatch\fR文がない場合に例外が発生すると、JVMは通常、例外トレースを出力して終了します。ただし、JDB環境で実行している場合は、違反のスロー時にJDBに制御が戻ります。次に、\fIjdb\fRコマンドを使用して例外の原因を診断します。
.PP
たとえば、\fIcatch java\&.io\&.FileNotFoundException\fRまたは\fIcatch\fR
\fImypackage\&.BigTroubleException\fRのように\fIcatch\fRコマンドを使用すると、デバッグされたアプリケーションは、他の例外がスローされたときに停止します。例外が特定のクラスまたはサブクラスのインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。
.PP
\fIignore\fRコマンドを使用すると、以前の\fIcatch\fRコマンドの効果が無効になります。\fIignore\fRコマンドでは、デバッグされるJVMは特定の例外を無視せず、デバッガのみを無視します。
.SH "オプション"
.PP
コマンドラインで\fIjava\fRコマンドのかわりに\fIjdb\fRコマンドを使用する場合、\fIjdb\fRコマンドは、\fI\-D\fR、\fI\-classpath\fR、\fI\-X\fRなど、\fIjava\fRコマンドと同じ数のオプションを受け入れます。\fIjdb\fRコマンドは、その他に次のリストにあるオプションを受け入れます。
.PP
デバッグを行うJVMにデバッガを接続するための代替機構を提供するために、その他のオプションがサポートされています。これらの接続の代替に関する詳細なドキュメントは、Java Platform Debugger Architecture (JPDA)
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jpda/index\&.html)を参照してください
.PP
\-help
.RS 4
ヘルプ・メッセージを表示します。
.RE
.PP
\-sourcepath \fIdir1:dir2: \&. \&. \&.\fR
.RS 4
指定されたパスを使用して、ソース・ファイルを検索します。このオプションが指定されていない場合は、デフォルト・パスのドット(\&.)が使用されます。
.RE
.PP
\-attach \fIaddress\fR
.RS 4
デフォルトの接続機構を使用して、実行中のJVMにデバッガを接続します。
.RE
.PP
\-listen \fIaddress\fR
.RS 4
実行中のJVMが標準のコネクタを使用して指定されたアドレスに接続するのを待機します。
.RE
.PP
\-launch
.RS 4
デバッグするアプリケーションをJDBの起動後ただちに起動します。\fI\-launch\fRオプションにより、\fIrun\fRコマンドが必要なくなります。デバッグするアプリケーションは、起動後、初期アプリケーション・クラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\fIcont\fRコマンドを使用して実行を継続できます。
.RE
.PP
\-listconnectors
.RS 4
このJVMで利用できるコネクタを一覧表示します。
.RE
.PP
\-connect connector\-name:\fIname1=value1\fR
.RS 4
一覧表示された引数の値と指定のコネクタを使用してターゲットJVMに接続します。
.RE
.PP
\-dbgtrace [\fIflags\fR]
.RS 4
\fIjdb\fRコマンドのデバッグの情報を出力します。
.RE
.PP
\-tclient
.RS 4
Java HotSpot VMクライアント内でアプリケーションを実行します。
.RE
.PP
\-tserver
.RS 4
Java HotSpot VMサーバー内でアプリケーションを実行します。
.RE
.PP
\-J\fIoption\fR
.RS 4
JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE
.SH "デバッグ対象のプロセスに転送されるオプション"
.PP
\-v \-verbose[:\fIclass\fR|gc|jni]
.RS 4
冗長モードにします。
.RE
.PP
\-D\fIname\fR=\fIvalue\fR
.RS 4
システム・プロパティを設定します。
.RE
.PP
\-classpath \fIdir\fR
.RS 4
クラスを検索するための、コロンで区切って指定されたディレクトリのリスト。
.RE
.PP
\-X\fIoption\fR
.RS 4
非標準ターゲットJVMオプションです。
.RE .RE
.LP
.SH "´ØÏ¢¹àÌÜ" .SH "´ØÏ¢¹àÌÜ"
.LP .sp
.LP .RS 4
javac(1)、java(1)、javah(1)、javap(1)、javadoc(1) .ie n \{\
.LP \h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javac(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javah(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javap(1)
.RE
.br
'pl 8.5i
'bp

367
jdk/src/linux/doc/man/ja/jdeps.1 Normal file
View File

@ -0,0 +1,367 @@
'\" t
.\" Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
.\" Title: jdeps
.\" Language: English
.\" Date: 2013年11月21日
.\" SectDesc: 基本ツール
.\" Software: JDK 8
.\" Arch: 汎用
.\"
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.pl 99999
.TH "jdeps" "1" "2013年11月21日" "JDK 8" "基本ツール"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jdeps \- Javaクラス依存性アナライザ。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjdeps\fR [\fIoptions\fR] \fIclasses\fR \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.PP
\fIclasses\fR
.RS 4
分析するクラスの名前。クラス・パスで検出できるクラスを、ファイル名、ディレクトリまたはJARファイルで指定できます。
.RE
.SH "説明"
.PP
\fIjdeps\fRコマンドは、Javaクラス・ファイルのパッケージレベルまたはクラスレベルの依存性を示します。入力クラスには、\fI\&.class\fRファイルのパス名、ディレクトリ、JARファイル、またはすべてのクラス・ファイルを分析するための完全修飾クラス名を指定できます。オプションにより出力が決定します。デフォルトでは、\fIjdeps\fRはシステム出力に依存関係を出力します。DOT言語で依存関係を生成できます(\fI\-dotoutput\fRオプションを参照)。
.SH "オプション"
.PP
\-dotoutput <\fIdir\fR>
.RS 4
DOTファイル出力の宛先ディレクトリ。指定した場合は\fIjdeps\fRは<\fIarchive\-file\-name\fR>\&.dotという名前の分析済みアーカイブごとに依存関係をリストする1つのdotファイルを生成し、アーカイブ間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも生成します。
.RE
.PP
\-s, \-summary
.RS 4
依存関係のサマリーのみを出力します。
.RE
.PP
\-v, \-verbose
.RS 4
すべてのクラスレベルの依存関係を出力します。
.RE
.PP
\-verbose:package
.RS 4
同じアーカイブ内の依存関係を除き、パッケージレベルの依存関係を出力します。
.RE
.PP
\-verbose:class
.RS 4
同じアーカイブ内の依存関係を除き、クラスレベルの依存関係を出力します。
.RE
.PP
\-cp <\fIpath\fR>, \-classpath <\fIpath\fR>
.RS 4
クラス・ファイルの検索場所を指定します。
.sp
Setting the Class Path も参照してください。
.RE
.PP
\-p <\fIpkg name\fR>, \-package <\fIpkg name\fR>
.RS 4
指定したパッケージの依存関係を検出します。異なるパッケージに対してこのオプションを複数回指定できます。\fI\-p\fRオプションと\fI\-e\fRオプションを同時に指定することはできません。
.RE
.PP
\-e <\fIregex\fR>, \-regex <\fIregex\fR>
.RS 4
指定した正規表現パターンと一致するパッケージの依存関係を検出します。\fI\-p\fRオプションと\fI\-e\fRオプションを同時に指定することはできません。
.RE
.PP
\-include <\fIregex\fR>
.RS 4
分析をパターンに一致するクラスに制限します。このオプションは、分析するクラスのリストをフィルタします。依存関係にパターンを適用する\fI\-p\fRおよび\fI\-e\fRとともに使用できます。
.RE
.PP
\-jdkinternals
.RS 4
JDKの内部APIのクラスレベルの依存関係を検出します。デフォルトでは、\fI\-include\fRオプションを指定しないかぎり、\fI\-classpath\fRオプションおよび入力ファイルに指定されたすべてのクラスを分析します。このオプションは、\fI\-p\fRオプション、\fI\-e\fRオプションおよび\fI\-s\fRオプションとともに使用できません。
.sp
\fB警告\fR: JDKの内部APIは、今後のリリースでアクセスできなくなる可能性があります。
.RE
.PP
\-P, \-profile
.RS 4
パッケージを含むプロファイルまたはファイルを表示します。
.RE
.PP
\-apionly
.RS 4
フィールド・タイプ、メソッド・パラメータ・タイプ、戻りタイプ、チェックされた例外タイプを含むパブリック・クラスの\fIpublic\fRおよび\fIprotected\fRメンバーの署名からの依存関係など、分析をAPIに制限します。
.RE
.PP
\-R, \-recursive
.RS 4
すべての依存関係を再帰的に走査します。
.RE
.PP
\-version
.RS 4
バージョン情報を出力します。
.RE
.PP
\-h, \-?, \-help
.RS 4
\fIjdeps\fRに関するヘルプ・メッセージを出力します。
.RE
.SH "例"
.PP
Notepad\&.jarの依存関係の分析。
.sp
.if n \{\
.RS 4
.\}
.nf
$ jdeps demo/jfc/Notepad/Notepad\&.jar
demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar
<unnamed> (Notepad\&.jar)
\-> java\&.awt
\-> java\&.awt\&.event
\-> java\&.beans
\-> java\&.io
\-> java\&.lang
\-> java\&.net
\-> java\&.util
\-> java\&.util\&.logging
\-> javax\&.swing
\-> javax\&.swing\&.border
\-> javax\&.swing\&.event
\-> javax\&.swing\&.text
\-> javax\&.swing\&.tree
\-> javax\&.swing\&.undo
.fi
.if n \{\
.RE
.\}
.PP
\-Pまたは\-profileオプションを使用して、メモ帳が依存するプロファイルを表示します。
.sp
.if n \{\
.RS 4
.\}
.nf
$ jdeps \-profile demo/jfc/Notepad/Notepad\&.jar
demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar (Full JRE)
<unnamed> (Notepad\&.jar)
\-> java\&.awt Full JRE
\-> java\&.awt\&.event Full JRE
\-> java\&.beans Full JRE
\-> java\&.io compact1
\-> java\&.lang compact1
\-> java\&.net compact1
\-> java\&.util compact1
\-> java\&.util\&.logging compact1
\-> javax\&.swing Full JRE
\-> javax\&.swing\&.border Full JRE
\-> javax\&.swing\&.event Full JRE
\-> javax\&.swing\&.text Full JRE
\-> javax\&.swing\&.tree Full JRE
\-> javax\&.swing\&.undo Full JRE
.fi
.if n \{\
.RE
.\}
.PP
tools\&.jarファイル内の\fIcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスなど、特定のクラスパス内の特定のクラスの直接依存関係の分析。
.sp
.if n \{\
.RS 4
.\}
.nf
$ jdeps \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main
lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar
com\&.sun\&.tools\&.jdeps (tools\&.jar)
\-> java\&.io
\-> java\&.lang
.fi
.if n \{\
.RE
.\}
.PP
\fI\-verbose:class\fRオプションを使用して、クラスレベル依存関係を検索するか\fI\-v\fRまたは\fI\-verbose\fRオプションを使用して同じJARファイルからの依存関係を含めます。
.sp
.if n \{\
.RS 4
.\}
.nf
$ jdeps \-verbose:class \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main
lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar
com\&.sun\&.tools\&.jdeps\&.Main (tools\&.jar)
\-> java\&.io\&.PrintWriter
\-> java\&.lang\&.Exception
\-> java\&.lang\&.Object
\-> java\&.lang\&.String
\-> java\&.lang\&.System
.fi
.if n \{\
.RE
.\}
.PP
\fI\-R\fRまたは\fI\-recursive\fRオプションを使用して、\fIcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスの推移的な依存関係を分析します。
.sp
.if n \{\
.RS 4
.\}
.nf
$ jdeps \-R \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main
lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar
com\&.sun\&.tools\&.classfile (tools\&.jar)
\-> java\&.io
\-> java\&.lang
\-> java\&.lang\&.reflect
\-> java\&.nio\&.charset
\-> java\&.nio\&.file
\-> java\&.util
\-> java\&.util\&.regex
com\&.sun\&.tools\&.jdeps (tools\&.jar)
\-> java\&.io
\-> java\&.lang
\-> java\&.nio\&.file
\-> java\&.nio\&.file\&.attribute
\-> java\&.text
\-> java\&.util
\-> java\&.util\&.jar
\-> java\&.util\&.regex
\-> java\&.util\&.zip
/usr/java/jre/lib/jce\&.jar \-> /usr/java/jre/lib/rt\&.jar
javax\&.crypto (jce\&.jar)
\-> java\&.io
\-> java\&.lang
\-> java\&.lang\&.reflect
\-> java\&.net
\-> java\&.nio
\-> java\&.security
\-> java\&.security\&.cert
\-> java\&.security\&.spec
\-> java\&.util
\-> java\&.util\&.concurrent
\-> java\&.util\&.jar
\-> java\&.util\&.regex
\-> java\&.util\&.zip
\-> javax\&.security\&.auth
\-> sun\&.security\&.jca JDK internal API (rt\&.jar)
\-> sun\&.security\&.util JDK internal API (rt\&.jar)
javax\&.crypto\&.spec (jce\&.jar)
\-> java\&.lang
\-> java\&.security\&.spec
\-> java\&.util
/usr/java/jre/lib/rt\&.jar \-> /usr/java/jre/lib/jce\&.jar
java\&.security (rt\&.jar)
\-> javax\&.crypto
.fi
.if n \{\
.RE
.\}
.PP
メモ帳デモの依存関係のdotファイルを生成します。
.sp
.if n \{\
.RS 4
.\}
.nf
$ jdeps \-dotoutput dot demo/jfc/Notepad/Notepad\&.jar
.fi
.if n \{\
.RE
.\}
.PP
\fIjdeps\fRは、\fI\-dotoutput\fRオプションで指定されたdotディレクトリに<\fIfilename\fR>\&.dotという名前のdotファイルを特定のJARファイルごとに作成し、JARファイル間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも作成します
.sp
.if n \{\
.RS 4
.\}
.nf
$ cat dot/Notepad\&.jar\&.dot
digraph "Notepad\&.jar" {
// Path: demo/jfc/Notepad/Notepad\&.jar
"<unnamed>" \-> "java\&.awt";
"<unnamed>" \-> "java\&.awt\&.event";
"<unnamed>" \-> "java\&.beans";
"<unnamed>" \-> "java\&.io";
"<unnamed>" \-> "java\&.lang";
"<unnamed>" \-> "java\&.net";
"<unnamed>" \-> "java\&.util";
"<unnamed>" \-> "java\&.util\&.logging";
"<unnamed>" \-> "javax\&.swing";
"<unnamed>" \-> "javax\&.swing\&.border";
"<unnamed>" \-> "javax\&.swing\&.event";
"<unnamed>" \-> "javax\&.swing\&.text";
"<unnamed>" \-> "javax\&.swing\&.tree";
"<unnamed>" \-> "javax\&.swing\&.undo";
}
$ cat dot/summary\&.dot
digraph "summary" {
"Notepad\&.jar" \-> "rt\&.jar";
}
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
javap(1)
.RE
.br
'pl 8.5i
'bp

355
jdk/src/linux/doc/man/ja/jhat.1
View File

@ -1,159 +1,214 @@
." Copyright (c) 2006, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jhat
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: トラブルシューティング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jhat 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jhat \- Java ヒープ解析ツール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jhat" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
関連項目 .\" -----------------------------------------------------------------
.RE .\" disable hyphenation
.nh
.LP .\" disable justification (adjust text to left margin only)
.SH "形式" .ad l
.LP .\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jhat \- Javaヒープを分析します。このコマンドは試験的なもので、サポートされていません。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR
.fl
\fP\f3jhat\fP [ \f2options\fP ] <heap\-dump\-file>
.fl
.fl
.fi .fi
.if n \{\
.LP .RE
.SH "パラメータ" .\}
.LP .PP
.RS 3 \fIoptions\fR
.TP 3 .RS 4
options コマンドライン・オプション。オプションを参照してください。
オプションを使用する場合、コマンド名の直後に記述してください。 .RE
.TP 3 .PP
heap\-dump\-file \fIheap\-dump\-file\fR
ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。 .RS 4
ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fImyfile\&.hprof#3\fRのようにファイル名の後に\fI#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。
.RE .RE
.LP
.SH "説明" .SH "説明"
.LP .PP
.LP \fIjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fIjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fIjhat\fRコマンドは、既知のクラス\fIMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fIjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。
\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバーを起動します。jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。 .PP
.LP Javaのヒープ・ダンプを生成するには、次のいくつかの方法があります。
.LP .sp
Java のヒープダンプを生成するには、いくつかの方法があります。 .RS 4
.LP .ie n \{\
.RS 3 \h'-04'\(bu\h'+03'\c
.TP 2 .\}
o .el \{\
jmap(1) の \-dump オプションを使って実行時にヒープダンプを取得する。 .sp -1
.TP 2 .IP \(bu 2.3
o .\}
jconsole(1) のオプションを使って \fIjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。
.na .RE
\f2HotSpotDiagnosticMXBean\fP @ .sp
.fi .RS 4
http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 経由で実行時にヒープダンプを取得する。 .ie n \{\
.TP 2 \h'-04'\(bu\h'+03'\c
o .\}
\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。 .el \{\
.TP 2 .sp -1
o .IP \(bu 2.3
.na .\}
\f2hprof\fP @ \fIjconsole\fRオプションを使用して\fIHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fIHotSpotDiagnosticMXBean\fRのインタフェースの説明(
.fi http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html)を参照してください。
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html を使用する。 .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ヒープ・ダンプは、\fI\-XX:+HeapDumpOnOutOfMemoryError\fR
Java仮想マシン(JVM)オプションを指定することで、\fIOutOfMemoryError\fRがスローされたときに生成されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール
(http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)を参照してください
.RE .RE
.LP
.LP
\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-stack false|true
.TP 3 .RS 4
\-stack false/true オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fIfalse\fRに設定する必要があります。デフォルトは\fItrue\fRです。
オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。 .RE
.TP 3 .PP
\-refs false/true \-refs false|true
オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる) が計算されます。 .RS 4
.TP 3 オブジェクトへの参照の追跡を無効にします。デフォルトは\fItrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。
\-port port\-number .RE
jhat の HTTP サーバーのポートを設定します。デフォルトは 7000 です。 .PP
.TP 3 \-port \fIport\-number\fR
\-exclude exclude\-file .RS 4
「到達可能なオブジェクト」のクエリから除外すべきデータメンバーの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。 \fIjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。
.TP 3 .RE
\-baseline baseline\-dump\-file .PP
ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。 \-exclude \fIexclude\-file\fR
.TP 3 .RS 4
\-debug int 到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fIjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fIo\fRから到達可能なオブジェクトのリストを計算する際に、\fIjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。
このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。 .RE
.TP 3 .PP
\-version \-baseline \fIexclude\-file\fR
バージョン番号を報告したあと、終了します。 .RS 4
.TP 3 ベースラインとなるヒープ・ダンプを指定します。両方のヒープ・ダンプ内で同じオブジェクトIDを持つオブジェクトは新規ではないとしてマークされます。他のオブジェクトは新規としてマークされます。これは、異なる2つのヒープ・ダンプを比較する際に役立ちます。
\-h .RE
ヘルプメッセージを出力して終了します。 .PP
.TP 3 \-debug \fIint\fR
\-help .RS 4
ヘルプメッセージを出力して終了します。 このツールのデバッグ・レベルを設定します。レベル0はデバッグ出力がないことを意味します。より大きな値を設定すると、より冗長なモードになります。
.TP 3 .RE
\-J<flag> .PP
jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。 \-version
.RS 4
リリース番号をレポートして終了します
.RE
.PP
\-h
.RS 4
ヘルプ・メッセージを表示して終了します。
.RE
.PP
\-help
.RS 4
ヘルプ・メッセージを表示して終了します。
.RE
.PP
\-J\fIflag\fR
.RS 4
\fIjhat\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fI\-J\-Xmx512m\fRとします。
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.RS 3 .RS 4
.TP 2 .ie n \{\
o \h'-04'\(bu\h'+03'\c
jmap(1) .\}
.TP 2 .el \{\
o .sp -1
jconsole(1) .IP \(bu 2.3
.TP 2 .\}
o jmap(1)
.na
\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @
.fi
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
.RE .RE
.sp
.LP .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jconsole(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
HPROF: Heap/CPUプロファイリング・ツール
(http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)
.RE
.br
'pl 8.5i
'bp

326
jdk/src/linux/doc/man/ja/jinfo.1
View File

@ -1,166 +1,186 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jinfo
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: トラブルシューティング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jinfo 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jinfo \- 構成情報 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jinfo" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
関連項目 .\" -----------------------------------------------------------------
.RE .\" disable hyphenation
.nh
.LP .\" disable justification (adjust text to left margin only)
.SH "形式" .ad l
.LP .\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jinfo \- 構成情報を生成します。このコマンドは試験的なもので、サポートされていません。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjinfo\fR [ \fIoption\fR ] \fIpid\fR
.fl
\fP\f3jinfo\fP [ option ] pid
.fl
\f3jinfo\fP [ option ] executable core
.fl
\f3jinfo\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.RS 3
.TP 3
option
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
.RE .RE
.\}
.LP .sp
.RS 3 .if n \{\
.TP 3 .RS 4
pid .\}
出力する構成情報のプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。 .nf
\fIjinfo\fR [ \fIoption \fR] \fIexecutable core\fR
.fi
.if n \{\
.RE .RE
.\}
.LP .sp
.RS 3 .if n \{\
.TP 3 .RS 4
executable .\}
コアダンプの作成元の Java 実行可能ファイルです。 .nf
\fIjinfo\fR [ \fIoption \fR] \fI[ servier\-id ] remote\-hostname\-or\-IP\fR
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
.RS 3 \fIオプション\fR
.TP 3 .RS 4
core コマンドライン・オプション。オプションを参照してください。
出力する構成情報のコアファイル。
.RE .RE
.PP
.LP \fIpid\fR
.RS 3 .RS 4
.TP 3 構成情報が出力されるプロセスID。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)コマンドを使用します。
remote\-hostname\-or\-IP
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.RE .RE
.PP
.LP \fI実行可能ファイル\fR
.RS 3 .RS 4
.TP 3 コア・ダンプの作成元のJava実行可能ファイル。
server\-id .RE
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 .PP
\fIコア\fR
.RS 4
構成情報が出力されるコア・ファイル。
.RE
.PP
\fIremote\-hostname\-or\-IP\fR
.RS 4
リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。
.RE
.PP
\fIserver\-id\fR
.RS 4
複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合の、オプション固有のID。
.RE .RE
.LP
.SH "説明" .SH "説明"
.LP .PP
.LP \fIjinfo\fRコマンドは、指定されたJavaプロセスやコア・ファイルまたはリモート・デバッグ・サーバーのJava構成情報を出力します。構成情報には、Javaシステム・プロパティとJava仮想マシン(JVM)のコマンドライン・フラグが含まれています。指定されたプロセスが64ビットJVM上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjinfo\fR
\f3jinfo\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーの Java 構成情報を出力します。構成情報は、Java システムプロパティーと Java 仮想マシンのコマンド行フラグから構成されます。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 \fI\-J\-d64 \-sysprops pid\fR。
.br .PP
jinfo \-J\-d64 \-sysprops pid このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。たとえば、\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fRです。
.LP
.LP
\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP
.LP
.LP
\f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 no\-option
.TP 3 .RS 4
<オプションなし> コマンドライン・フラグを、システム・プロパティ名と値のペアとともに出力します。
コマンド行フラグを、システムプロパティー名と値のペアとともに出力します。 .RE
.br .PP
.TP 3 \-flag \fIname\fR
\-flag name .RS 4
指定されたコマンド行フラグの名前と値を出力します。 指定されたコマンドライン・フラグの名前と値を出力します。
.br .RE
.TP 3 .PP
\-flag [+|\-]name \-flag \fI[+|\-]name\fR
指定されたブール型のコマンド行フラグを有効または無効にします。 .RS 4
.br 指定されたブール型のコマンドライン・フラグを有効または無効にします。
.TP 3 .RE
\-flag name=value .PP
指定されたコマンド行フラグを指定された値に設定します。 \-flag \fIname=value\fR
.br .RS 4
.TP 3 指定されたコマンドライン・フラグを指定された値に設定します。
\-flags .RE
JVM に渡されるコマンド行フラグをペアで出力します。 .PP
.br \-flags
.TP 3 .RS 4
\-sysprops JVMに渡されるコマンドライン・フラグを出力します。
Java システムプロパティーを名前と値のペアとして出力します。 .RE
.br .PP
.TP 3 \-sysprops
\-h .RS 4
ヘルプメッセージを出力します。 Javaシステム・プロパティを名前と値のペアとして出力します。
.TP 3 .RE
\-help .PP
ヘルプメッセージを出力します。 \-h
.RS 4
ヘルプ・メッセージが出力されます。
.RE
.PP
\-help
.RS 4
ヘルプ・メッセージが出力されます。
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.RS 3 .RS 4
.TP 2 .ie n \{\
o \h'-04'\(bu\h'+03'\c
jps(1) .\}
.TP 2 .el \{\
o .sp -1
jsadebugd(1) .IP \(bu 2.3
.\}
jps(1)
.RE .RE
.sp
.LP .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jsadebugd(1)
.RE
.br
'pl 8.5i
'bp

394
jdk/src/linux/doc/man/ja/jjs.1 Normal file
View File

@ -0,0 +1,394 @@
'\" t
.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved.
.\" Title: jjs
.\" Language: English
.\" Date: 2013年11月21日
.\" SectDesc: 基本ツール
.\" Software: JDK 8
.\" Arch: 汎用
.\"
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.pl 99999
.TH "jjs" "1" "2013年11月21日" "JDK 8" "基本ツール"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jjs \- Nashornエンジンを呼び出します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIjjs\fR [\fIoptions\fR] [\fIscript\-files\fR] [\-\- \fIarguments\fR]
.fi
.if n \{\
.RE
.\}
.PP
\fIoptions\fR
.RS 4
空白文字で区切られた、\fIjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。
.RE
.PP
\fIscript\-files\fR
.RS 4
空白文字で区切られた、Nashornを使用して解釈する1つ以上のスクリプト・ファイル。ファイルが指定されない場合は、対話型シェルが起動されます。
.RE
.PP
\fIarguments\fR
.RS 4
二重ハイフン・マーカー(\fI\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fIarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。
.RE
.SH "説明"
.PP
\fIjjs\fRコマンドライン・ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。
.SH "オプション"
.PP
\fIjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。
.PP
\-ccs=\fIsize\fR, \-\-class\-cache\-size=\fIsize\fR
.RS 4
クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fIk\fRまたは\fIK\fRの文字を追加し、メガバイト(MB)を示すために\fIm\fRまたは\fIM\fRの文字を追加し、ギガバイト(GB)を示すために\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。
.sp
.if n \{\
.RS 4
.\}
.nf
\-css=100
\-css=1k
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-co, \-\-compile\-only
.RS 4
スクリプトを実行せずにコンパイルします。
.RE
.PP
\-cp \fIpath\fR, \-\-classpath \fIpath\fR
.RS 4
サポートするクラスへのパスを指定します。複数のパスを設定するには、このオプションを繰り返すか、または各パスをコロン(:)で区切ります。
.RE
.PP
\-D\fIname\fR=\fIvalue\fR
.RS 4
プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fImyValue\fRを\fImyKey\fRという名前のプロパティに割り当てる方法を示します。
.sp
.if n \{\
.RS 4
.\}
.nf
>> \fBjjs \-DmyKey=myValue\fR
jjs> \fBjava\&.lang\&.System\&.getProperty("myKey")\fR
myValue
jjs>
.fi
.if n \{\
.RE
.\}
このオプションを繰り返し使用すると、複数のプロパティを設定できます。
.RE
.PP
\-d=\fIpath\fR, \-\-dump\-debug\-dir=\fIpath\fR
.RS 4
クラス・ファイルをダンプするディレクトリへのパスを指定します。
.RE
.PP
\-\-debug\-lines
.RS 4
クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-debug\-lines=false\fRを指定します。
.RE
.PP
\-\-debug\-locals
.RS 4
クラス・ファイル内のローカル変数を生成します。
.RE
.PP
\-doe, \-\-dump\-on\-error
.RS 4
エラーが発生したときに、フル・スタック・トレースを提供します。デフォルトでは、簡単なエラー・メッセージのみが出力されます。
.RE
.PP
\-\-early\-lvalue\-error
.RS 4
無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。
.RE
.PP
\-\-empty\-statements
.RS 4
空の文をJavaの抽象構文ツリーに保存します。
.RE
.PP
\-fv, \-\-fullversion
.RS 4
完全なNashornバージョン文字列を出力します。
.RE
.PP
\-\-function\-statement\-error
.RS 4
関数の宣言が文として使用されるとエラー・メッセージが出力されます。
.RE
.PP
\-\-function\-statement\-warning
.RS 4
関数の宣言が文として使用されると警告メッセージが出力されます。
.RE
.PP
\-fx
.RS 4
スクリプトをJavaFXアプリケーションとして起動します。
.RE
.PP
\-h, \-help
.RS 4
オプションのリストとその説明を出力します。
.RE
.PP
\-J\fIoption\fR
.RS 4
指定した\fIjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。
.sp
.if n \{\
.RS 4
.\}
.nf
>> \fBjjs \-J\-Xmx4g\fR
jjs> \fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR
3817799680
jjs>
.fi
.if n \{\
.RE
.\}
このオプションを繰り返し使用すると、複数の\fIjava\fRコマンド・オプションを渡すことができます。
.RE
.PP
\-\-lazy\-compilation
.RS 4
レイジー・コード生成戦略(つまり、スクリプト全体が一度にコンパイルされない)を有効にします。このオプションは試験的なものです。
.RE
.PP
\-\-loader\-per\-compile
.RS 4
コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-loader\-per\-compile=false\fRを指定します。
.RE
.PP
\-\-log=\fIsubsystem\fR:\fIlevel\fR
.RS 4
指定されたサブシステムに対して、特定のレベルでロギングを実行します。カンマで区切って複数のサブシステムのロギング・レベルを指定できます。次に例を示します。
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-log=fields:finest,codegen:info
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-package=\fIname\fR
.RS 4
生成されたクラス・ファイルを追加するパッケージを指定します。
.RE
.PP
\-\-parse\-only
.RS 4
コンパイルせずにコードを解析します。
.RE
.PP
\-\-print\-ast
.RS 4
抽象構文ツリーを出力します。
.RE
.PP
\-\-print\-code
.RS 4
バイトコードを出力します。
.RE
.PP
\-\-print\-lower\-ast
.RS 4
掘り下げた抽象構文ツリーを出力します。
.RE
.PP
\-\-print\-lower\-parse
.RS 4
掘り下げた解析ツリーを出力します。
.RE
.PP
\-\-print\-no\-newline
.RS 4
その他の\fI\-\-print*\fRオプションで強制的に1行で出力します。
.RE
.PP
\-\-print\-parse
.RS 4
解析ツリーを出力します。
.RE
.PP
\-\-print\-symbols
.RS 4
記号表を出力します。
.RE
.PP
\-pcs, \-\-profile\-callsites
.RS 4
呼び出しサイトのプロファイル・データをダンプします。
.RE
.PP
\-scripting
.RS 4
シェルのスクリプト機能を有効にします。
.RE
.PP
\-\-stderr=\fIfilename\fR|\fIstream\fR|\fItty\fR
.RS 4
標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fIstdout\fR)に、またはテキスト端末にリダイレクトします。
.RE
.PP
\-\-stdout=\fIfilename\fR|\fIstream\fR|\fItty\fR
.RS 4
標準出力ストリームを指定したファイル、ストリーム(たとえば\fIstderr\fR)に、またはテキスト端末にリダイレクトします。
.RE
.PP
\-strict
.RS 4
標準(ECMAScript Edition 5\&.1)への準拠を強化するstrictモードを有効にし、これにより共通のコーディング・エラーを簡単に検出できるようになります。
.RE
.PP
\-t=\fIzone\fR, \-timezone=\fIzone\fR
.RS 4
スクリプトの実行に対し指定したタイムゾーンを設定します。OSで設定されたタイムゾーンをオーバーライドし、\fIDate\fRオブジェクトで使用されます。
.RE
.PP
\-tcs=\fIparameter\fR, \-\-trace\-callsites=\fIparameter\fR
.RS 4
呼出しサイトのトレースのモードを有効にします。使用可能なパラメータは、次のとおりです。
.PP
miss
.RS 4
呼出しサイトのミスをトレースします。
.RE
.PP
enterexit
.RS 4
呼出しサイトへの出入りをトレースします。
.RE
.PP
objects
.RS 4
オブジェクトのプロパティを出力します。
.RE
.RE
.PP
\-\-verify\-code
.RS 4
バイトコードを実行する前に検証します。
.RE
.PP
\-v, \-version
.RS 4
Nashornバージョン文字列を出力します。
.RE
.PP
\-xhelp
.RS 4
コマンドライン・オプションの拡張ヘルプを出力します。
.RE
.SH "例"
.PP
\fBExample 1\fR, Nashornを使用したスクリプトの実行
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
jjs script\&.js
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fBExample 2\fR, 対話型モードでのNashornの実行
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
>> \fBjjs\fR
jjs> \fBprintln("Hello, World!")\fR
Hello, World!
jjs> \fBquit()\fR
>>
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fBExample 3\fR, Nashornへの引数の渡し
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
>> \fBjjs \-\- a b c\fR
jjs> \fBarguments\&.join(", ")\fR
a, b, c
jjs>
.fi
.if n \{\
.RE
.\}
.RE
.SH "関連項目"
.PP
\fIjrunscript\fR
.br
'pl 8.5i
'bp

372
jdk/src/linux/doc/man/ja/jmap.1
View File

@ -1,179 +1,209 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jmap
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: トラブルシューティング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jmap 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jmap \- メモリーマップ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jmap" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
関連項目 .\" -----------------------------------------------------------------
.RE .\" disable hyphenation
.nh
.LP .\" disable justification (adjust text to left margin only)
.SH "形式" .ad l
.LP .\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jmap \- プロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。このコマンドは試験的なもので、サポートされていません。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjmap\fR [ \fIoptions\fR ] \fIpid\fR
.fl
\fP\f3jmap\fP [ option ] pid
.fl
\f3jmap\fP [ option ] executable core
.fl
\f3jmap\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi .fi
.if n \{\
.LP .RE
.SH "パラメータ" .\}
.LP .sp
.RS 3 .if n \{\
.TP 3 .RS 4
option .\}
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。 .nf
.TP 3 \fIjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR
pid .fi
印刷するメモリーマップのプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。 .if n \{\
.br .RE
.TP 3 .\}
executable .sp
コアダンプの作成元の Java 実行可能ファイルです。 .if n \{\
.br .RS 4
.TP 3 .\}
core .nf
印刷するメモリーマップのコアファイル。 \fIjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR
.br .fi
.TP 3 .if n \{\
remote\-hostname\-or\-IP .RE
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。 .\}
.br .PP
.TP 3 \fIoptions\fR
server\-id .RS 4
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 コマンドライン・オプション。オプションを参照してください。
.br .RE
.PP
\fIpid\fR
.RS 4
出力するメモリー・マップのプロセスID。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)コマンドを使用します。
.RE
.PP
\fI実行可能ファイル\fR
.RS 4
コア・ダンプの作成元のJava実行可能ファイル。
.RE
.PP
\fIコア\fR
.RS 4
出力するメモリー・マップのコア・ファイル。
.RE
.PP
\fIremote\-hostname\-or\-IP\fR
.RS 4
リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。
.RE
.PP
\fIserver\-id\fR
.RS 4
複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合の、オプション固有のID。
.RE .RE
.LP
.SH "説明" .SH "説明"
.LP .PP
.LP \fIjmap\fRコマンドは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットJava仮想マシン(JVM)上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjmap\fR
\f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 \fI\-J\-d64 \-heap pid\fR。
.LP .PP
.nf \fB注意:\fR
\f3 このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用される\fIjvm\&.dll\fRの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR。
.fl
jmap \-J\-d64 \-heap pid
.fl
\fP
.fi
.LP
.LP
\f3注: このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \fP\f4PATH\fP\f3 環境変数には、ターゲットプロセスによって使用される \fP\f4jvm.dll\fP\f3 の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。\fP
.LP
.LP
\f3次に例を示します。 \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.br
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 <オプションなし>
.TP 3 .RS 4
<オプションなし> オプションを使用しない場合、\fIjmap\fRコマンドは共用オブジェクト・マッピングを出力します。ターゲットJVMにロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズおよび共用オブジェクト・ファイルのフルパスが出力されます。この動作は、Oracle Solaris
オプションを使用しない場合、jmap は共用オブジェクトマッピングを印刷します。ターゲット VM にロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズ、および共用オブジェクトファイルのフルパスが印刷されます。これは、Solaris \f3pmap\fP ユーティリティーと類似しています。 \fIpmap\fRユーティリティと類似しています。
.br .RE
.TP 3 .PP
\-dump:[live,]format=b,file=<filename> \-dump:[live,] format=b, file=\fIfilename\fR
Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat(1) (Java Heap Analysis Tool) を使って読み取ります。 .RS 4
.br Javaヒープを\fIhprof\fRバイナリ形式で\fIfilename\fRにダンプします。\fIlive\fRサブオプションはオプションですが、指定した場合、ヒープ内のアクティブなオブジェクトのみがダンプされます。ヒープ・ダンプを参照するには、jhat(1)コマンドを使用して生成されたファイルを読み取ります。
.TP 3 .RE
\-finalizerinfo .PP
ファイナライズを待っているオブジェクトに関する情報を出力します。 \-finalizerinfo
.br .RS 4
.TP 3 ファイナライズを待っているオブジェクトに関する情報を出力します。
\-heap .RE
ヒープサマリーを印刷します。使用される GC アルゴリズム、ヒープ構成、および世代ごとのヒープ使用率が印刷されます。 .PP
.br \-heap
.TP 3 .RS 4
\-histo[:live] 使用されているガベージ・コレクションのヒープ・サマリー、ヘッダー構成、および世代関連のヒープ使用状況を出力します。さらに、internされた文字列の数とサイズも出力されます。
ヒープのヒストグラムを印刷します。Java クラスごとに、オブジェクトの数、バイト単位でのメモリーサイズ、および完全修飾クラス名が印刷されます。VM 内部クラス名は、「*」の接頭辞を付けて印刷されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。 .RE
.br .PP
.TP 3 \-histo[:live]
\-permstat .RS 4
Permanent 世代の Java ヒープの、クラスローダー関連の統計データを印刷します。クラスローダーごとに、その名前、状態、アドレス、親クラスローダー、およびクラスローダーがロードしたクラスの数とサイズが印刷されます。さらに、intern された文字列の数とサイズも出力されます。 ヒープのヒストグラムを出力します。Javaクラスごとに、オブジェクトの数、バイト単位でのメモリー・サイズ、および完全修飾クラス名が出力されます。JVMの内部クラス名はアスタリスク(*)の接頭辞を付けて出力されます。\fIlive\fRサブオプションが指定された場合、アクティブなオブジェクトのみがカウントされます。
.br .RE
.TP 3 .PP
\-F \-clstats
強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。 .RS 4
.br Javaヒープの、クラス・ローダー関連の統計データを出力します。クラス・ローダーごとに、その名前、状態、アドレス、親クラス・ローダー、およびクラス・ローダーがロードしたクラスの数とサイズが出力されます。
.TP 3 .RE
\-h .PP
ヘルプメッセージを印刷します。 \-F
.br .RS 4
.br 強制します。PIDが応答しないときに、このオプションを\fIjmap \-dump\fRまたは\fIjmap \-histo\fRオプションとともに使用します。このモードでは、\fIlive\fRサブオプションはサポートされません。
.TP 3 .RE
\-help .PP
ヘルプメッセージを印刷します。 \-h
.br .RS 4
.br ヘルプ・メッセージが出力されます。
.TP 3 .RE
\-J<flag> .PP
jmap が実行されている Java 仮想マシンに <flag> を渡します。 \-help
.br .RS 4
ヘルプ・メッセージが出力されます。
.RE
.PP
\-J\fIflag\fR
.RS 4
\fIjmap\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.RS 3 .RS 4
.TP 2 .ie n \{\
o \h'-04'\(bu\h'+03'\c
pmap (1) .\}
.TP 2 .el \{\
o .sp -1
jhat(1) .IP \(bu 2.3
.TP 2 .\}
o jhat(1)
jps(1)
.TP 2
o
jsadebugd(1)
.RE .RE
.sp
.LP .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jsadebugd(1)
.RE
.br
'pl 8.5i
'bp

513
jdk/src/linux/doc/man/ja/jps.1
View File

@ -1,278 +1,263 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jps
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: モニタリング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jps 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jps \- Java 仮想マシンプロセスステータスツール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jps" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
ホスト識別子 .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
出力形式 .\" disable justification (adjust text to left margin only)
.TP 2 .ad l
o .\" -----------------------------------------------------------------
例 .\" * MAIN CONTENT STARTS HERE *
.TP 2 .\" -----------------------------------------------------------------
o .SH "NAME"
関連項目 jps \- ターゲット・システム上で計測されたJava仮想マシン(JVM)を一覧表示します。このコマンドは試験的なもので、サポートされていません。
.RE .SH "概要"
.sp
.LP .if n \{\
.SH "形式" .RS 4
.LP .\}
.nf .nf
\f3 \fIjps\fR [ \fIoptions\fR ] [ \fIhostid\fR ]
.fl
\fP\f3jps\fP [ \f2options\fP ] [ \f2hostid\fP ]
.br
.fl
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.RS 3
.TP 3
options
コマンド行オプション。
.TP 3
hostid
プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。
.RE .RE
.\}
.LP .PP
.SH " 説明" \fIoptions\fR
.LP .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
\f3jps\fP ツールは、ターゲットシステム上で計測された HotSpot Java 仮想マシン (JVM) を一覧表示します。このツールで表示できるレポート情報は、アクセス権を持った JVM に関するものに限定されます。 .RE
.LP .PP
.LP \fIhostid\fR
\f2hostid\fP を指定せずに \f3jps\fP を実行した場合、ローカルホストで計測された JVM が検索されます。\f2hostid\fP を指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上の JVM を検索します。\f3jstatd\fP プロセスがターゲットホスト上で実行されていると想定されます。 .RS 4
.LP プロセス・レポートを生成するホストの識別子。\fIhostid\fRには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。ホスト識別子を参照してください。
.LP .RE
\f3jps\fP コマンドは、ターゲットシステムで計測された各 JVM について、ローカル VM 識別子、つまり \f2lvmid\fP をレポートします。\f3lvmid\fP は、必須ではありませんが、一般的には JVM プロセスに対するオペレーティングシステムのプロセス識別子です。オプションを指定しない場合、\f3jps\fP によって、各 Java アプリケーションの \f2lvmid\fP が一覧表示され、それぞれにアプリケーションのクラス名または JAR ファイル名が簡単な形式で示されます。この簡単な形式のクラス名と JAR ファイル名では、クラスのパッケージ情報または JAR ファイルパス情報が省略されています。 .SH "説明"
.LP .PP
.LP \fIjps\fRコマンドは、ターゲット・システム上で計測されたJava HotSpot VMを一覧表示します。このコマンドで表示できるレポート情報は、アクセス権を持ったJVMに関するものに限定されます。
\f3jps\fP コマンドは、\f3Java\fP 起動ツールを使用して \f2main\fP メソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲット JVM を起動した場合は、 \f2main\fP メソッドに渡されるクラス名 (または JAR ファイル名) と引数は利用できません。この場合、\f3jps\fP コマンドは、main メソッドへ渡されるクラス名 (または JAR ファイル名) と引数に対して、文字列 \f2Unknown\fP を出力します。 .PP
.LP \fIhostid\fRを指定せずに\fIjps\fRコマンドを実行した場合、ローカル・ホストで計測されたJVMが検索されます。\fIhostid\fRを指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上のJVMを検索します。\fIjstatd\fRプロセスがターゲット・ホスト上で実行されていると想定されます。
.LP .PP
\f3jps\fP コマンドで生成される JVM のリストは、このコマンドを実行する主体に与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティングシステム独自のアクセス制御機構による決定に基づいて、主体にアクセス権が与えられている JVM だけを一覧表示します。 \fIjps\fRコマンドは、ターゲット・システムで計測された各JVMについて、ローカルVM識別子、つまり\fIlvmid\fRをレポートします。\fIlvmid\fRは、一般的にはJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。オプションを指定しない場合、\fIjps\fRによって、各Javaアプリケーションの\fIlvmid\fRが一覧表示され、それぞれにアプリケーションのクラス名またはJARファイル名が簡単な形式で示されます。この簡単な形式のクラス名とJARファイル名では、クラスのパッケージ情報またはJARファイル・パス情報が省略されています。
.LP .PP
.LP \fIjps\fRコマンドは、Java起動ツールを使用してmainメソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲットJVMを起動した場合は、\fImain\fRメソッドに渡されるクラス名またはJARファイル名と引数は利用できません。この場合、\fIjps\fRコマンドは、\fImain\fRメソッドに渡されるクラス名またはJARファイル名と引数に対して、文字列\fIUnknown\fRを出力します。
\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。 .PP
.LP \fIjps\fRコマンドで生成されるJVMのリストは、このコマンドを実行するプリンシパルに与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティング・システム独自のアクセス制御機構による決定に基づいて、プリンシパルにアクセス権が与えられているJVMのみを一覧表示します。
.SH "オプション" .SH "オプション"
.LP .PP
.LP \fIjps\fRコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。
\f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 .PP
.LP \-q
.RS 3 .RS 4
.TP 3 クラス名、JARファイル名、および\fImain\fRメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。
\-q
クラス名、JAR ファイル名、および \f2main\fP メソッドに渡された引数の出力を抑制し、ローカル VM 識別子の一覧のみを生成します。
.TP 3
\-m
main メソッドに渡される引数を出力します。この出力は、組み込まれている JVM に対して null になることもあります。
.TP 3
\-l
アプリケーションの主要なクラスのフルパッケージ名、またはアプリケーションの JAR ファイルへのフルパス名を出力します。
.TP 3
\-v
JVM に渡される引数を出力します。
.TP 3
\-V
フラグファイル (.hotspotrc ファイルまたは \-XX:Flags=<\f2filename\fP> の引数で指定されたファイル) を通じて JVM に渡される引数を出力します。
.TP 3
\-Joption
\f3jps\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE .RE
.PP
.LP \-m
.SS .RS 4
ホスト識別子 \fImain\fRメソッドに渡される引数を出力します。この出力は、組み込まれているJVMに対して\fInull\fRになることもあります。
.LP
.LP
ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。
.LP
.nf
\f3
.fl
[\fP\f4protocol\fP\f3:][[//]\fP\f4hostname\fP\f3][:\fP\f4port\fP\f3][/\fP\f4servername\fP\f3]\fP
.br
\f3
.fl
\fP
.fi
.LP
.RS 3
.TP 3
protocol
通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。
.TP 3
hostname
ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。
.TP 3
port
リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。
.TP 3
servername
このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を示す文字列になります。jstatd(1) コマンドについては、\f3\-n\fP オプションを参照してください。
.RE .RE
.PP
.LP \-l
.SH "出力形式" .RS 4
.LP アプリケーションの\fImain\fRクラスのフル・パッケージ名、またはアプリケーションのJARファイルへのフルパス名を出力します。
.LP .RE
\f3jps\fP コマンドの出力は、次のパターンに従います。 .PP
.LP \-v
.RS 4
JVMに渡される引数を表示します。
.RE
.PP
\-V
.RS 4
クラス名、JARファイル名、およびmaiメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。
.RE
.PP
\-J\fIoption\fR
.RS 4
JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fIオプション\fRを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE
.SH "ホスト識別子"
.PP
ホスト識別子、つまり\fIhostid\fRは、ターゲット・システムを示す文字列です。\fIhostid\fR文字列の構文は、URIの構文に対応しています。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 [protocol:][[//]hostname][:port][/servername]
.fl
\fP\f4lvmid\fP\f3 [ [ \fP\f4classname\fP\f3 | \fP\f4JARfilename\fP\f3 | "Unknown"] [ \fP\f4arg\fP\f3* ] [ \fP\f4jvmarg\fP\f3* ] ]\fP
.br
\f3
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
すべての出力トークンは空白で区切ります。\f2arg\fP の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。 .PP
.br \fIprotocol\fR
.br .RS 4
\f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jps\fP の出力を解析するスクリプトは作成しないことをお勧めします。\f3jps\fP 出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトを変更する必要が予測されます。 通信プロトコルです。\fIprotocol\fRが省略され、\fIhostname\fRが指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。プロトコルが省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fIrmi\fRになります。
.br .RE
.PP
.LP hostname
.RS 4
ターゲット・ホストを示すホスト名またはIPアドレスです。\fIhostname\fRパラメータが省略されている場合は、ターゲット・ホストはローカル・ホストになります。
.RE
.PP
port
.RS 4
リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fRパラメータが省略されているか、\fIprotocol\fRパラメータが、最適化されたローカル・プロトコルを指定している場合、\fIport\fRパラメータは無視されます。それ以外の場合、\fIport\fRパラメータの扱いは、実装によって異なります。デフォルトの
\fIrmi\fRプロトコルの場合、\fIport\fRパラメータは、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fRパラメータが省略されているか、\fIprotocol\fRパラメータが\fIrmi\fRを示している場合、デフォルトのrmiregistryポート(1099)が使用されます。
.RE
.PP
servername
.RS 4
このパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fIrmi\fRプロトコルの場合、このパラメータは、リモート・ホスト上のRMIリモート・オブジェクトの名前を示す文字列になります。詳細は、\fIjstatd\fRコマンドの\fI\-n\fRオプションを参照してください。
.RE
.SH "出力フォーマット"
.PP
\fIjps\fRコマンドの出力は、次のパターンに従います。
.sp
.if n \{\
.RS 4
.\}
.nf
lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]
.fi
.if n \{\
.RE
.\}
.PP
すべての出力トークンは空白文字で区切られます。\fIarg\fR値の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。
.PP
\fB注意:\fR
将来のリリースでこの形式は変更される可能性があるため、\fIjps\fRの出力を解析するスクリプトは作成しないことをお薦めします。\fIjps\fR出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトの変更が必要になる可能性があります。
.SH "例" .SH "例"
.LP .PP
.LP この項では、\fIjps\fRコマンドの例を示します。
この節では、\f3jps\fP コマンドの例を示します。 .PP
.LP ローカル・ホスト上で計測されたJVMを一覧表示する場合:
.LP .sp
ローカルホスト上で計測された JVM を一覧表示する場合: .if n \{\
.LP .RS 4
.\}
.nf .nf
\f3 jps
.fl 18027 Java2Demo\&.JAR
\fP\f3jps\fP
.br
.fl
18027 Java2Demo.JAR
.br
.fl
18032 jps 18032 jps
.br
.fl
18005 jstat 18005 jstat
.br
.fl
.fi .fi
.if n \{\
.LP
.LP
リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
この例では、\f3jstat\fP サーバーと、その内部 RMI レジストリまたは別の外部 \f3rmiregistry\fP プロセスのいずれかとが、リモートホストのデフォルトポート (ポート 1099) で実行されていると想定しています。また、ローカルホストが、リモートホストへの有効なアクセス権を持っていることも想定しています。この例には、\f2\-l\fP オプションも含まれ、クラス名または JAR ファイル名を詳細な形式で出力します。
.LP
.nf
\f3
.fl
\fP\f3jps \-l remote.domain\fP
.br
.fl
3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
2857 sun.tools.jstatd.jstatd
.br
.fl
.fi
.LP
.LP
RMI レジストリにデフォルトではないポートを使用して、リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
この例では、内部 RMI レジストリがポート 2002 にバインドされた \f3jstatd\fP サーバーが、リモートホスト上で実行していると想定しています。また、\f2\-m\fP オプションを使用して、一覧表示されたそれぞれの Java アプリケーションの \f2main\fP メソッドに渡される引数を組み込んでいます。
.LP
.nf
\f3
.fl
\fP\f3jps \-m remote.domain:2002\fP
.br
.fl
3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
3102 sun.tools.jstatd.jstatd \-p 2002
.fl
.fi
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
「jstatd(1) \- 仮想マシン jstat デーモン」
.TP 2
o
「rmiregistry(1) \- Java リモートオブジェクトレジストリ」
.RE .RE
.\}
.LP .PP
次の例では、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、\fIjstat\fRサーバーと、その内部RMIレジストリまたは別の外部rmiregistryプロセスのいずれかが、リモート・ホストのデフォルト・ポート(ポート1099)で実行されていると想定しています。また、ローカル・ホストが、リモート・ホストへの有効なアクセス権を持っていることも想定しています。この例には、\fI\-l\fRオプションも含まれ、クラス名またはJARファイル名を詳細な形式で出力します。
.sp
.if n \{\
.RS 4
.\}
.nf
jps \-l remote\&.domain
3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR
2857 sun\&.tools\&.jstatd\&.jstatd
.fi
.if n \{\
.RE
.\}
.PP
次の例では、RMIレジストリにデフォルトではないポートを使用して、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、内部RMIレジストリがポート2002にバインドされた\fIjstatd\fRサーバーが、リモート・ホスト上で実行されていると想定しています。また、\fI\-m\fRオプションを使用して、一覧表示されたそれぞれのJavaアプリケーションの\fImain\fRメソッドに渡される引数を組み込んでいます。
.sp
.if n \{\
.RS 4
.\}
.nf
jps \-m remote\&.domain:2002
3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR
3102 sun\&.tools\&.jstatd\&.jstatd \-p 2002
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jstat(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jstatd(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rmiregistry(1)
.RE
.br
'pl 8.5i
'bp

378
jdk/src/linux/doc/man/ja/jrunscript.1
View File

@ -1,208 +1,206 @@
." Copyright (c) 2006, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jrunscript
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: スクリプティング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jrunscript 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jrunscript \- コマンド行スクリプトシェル .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jrunscript" "1" "2013年11月21日" "JDK 8" "スクリプティング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
引数 .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
例 .\" disable justification (adjust text to left margin only)
.TP 2 .ad l
o .\" -----------------------------------------------------------------
関連項目 .\" * MAIN CONTENT STARTS HERE *
.RE .\" -----------------------------------------------------------------
.SH "NAME"
.LP jrunscript \- 対話型モードとバッチ・モードをサポートするコマンドライン・スクリプト・シェルを実行します。このコマンドは試験的なもので、サポートされていません。
.SH "形式" .SH "概要"
.LP .sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjrunscript\fR [\fIoptions\fR] [\fIarguments\fR]
.fl
\fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]
.fl
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.RS 3
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
arguments
引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
.RE .RE
.\}
.LP .PP
.SH " 説明" \fIoptions\fR
.LP .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
\f3jrunscript\fP はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。 .RE
.LP .PP
.LP \fIarguments\fR
\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。 .RS 4
.LP 引数を使用する場合、オプションまたはコマンド名の直後に記述してください。引数を参照してください。
.RE
.SH "説明"
.PP
\fIjrunscript\fRコマンドは、言語に依存しないコマンドライン・スクリプト・シェルです。\fIjrunscript\fRは、対話型(read\-eval\-print)モードとバッチ(\fI\-f\fRオプション)・モードの両方のスクリプト実行をサポートします。デフォルトの使用言語はJavaScriptですが、\fI\-l\fRオプションを使用すれば他の言語も指定できます。\fIjrunscript\fRコマンドは、Javaとスクリプト言語との通信を使用して探求的なプログラミング・スタイルをサポートします。
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-classpath \fIpath\fR
.TP 3 .RS 4
\-classpath path スクリプトがアクセスする必要のあるクラス・ファイルの場所を示します。
スクリプトからのアクセス対象となるユーザーの .class ファイルの検索場所を指定します。 .RE
.TP 3 .PP
\-cp path \-cp \fIpath\fR
\-classpath \f2path\fP と同義です。 .RS 4
.TP 3 \fI\-classpath\fR
\-Dname=value \fIpath\fRと同じです。
Java のシステムプロパティーを設定します。 .RE
.TP 3 .PP
\-J<flag> \-D\fIname\fR=\fIvalue\fR
jrunscript が実行されている Java 仮想マシンに <flag> を渡します。 .RS 4
.TP 3 Javaのシステム・プロパティを設定します。
\-l language .RE
指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、\-cp、\-classpath のいずれかのオプションを使用します。 .PP
.TP 3 \-J\fIflag\fR
\-e script .RS 4
指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。 \fIflag\fRを、\fIjrunscript\fRコマンドが実行されているJava仮想マシンに直接渡します。
.TP 3 .RE
\-encoding encoding .PP
スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。 \-I \fIlanguage\fR
.TP 3 .RS 4
\-f script\-file 指定されたスクリプト言語を使用します。デフォルトではJavaScriptが使用されます。他のスクリプト言語を使用するには、\fI\-cp\fRまたは\fI\-classpath\fRオプションを使用して、対応するスクリプト・エンジンのJARファイルを指定する必要があります。
指定されたスクリプトファイルを評価します (バッチモード)。 .RE
.TP 3 .PP
\-f \- \-e \fIscript\fR
標準入力からスクリプトを読み取り、それを評価します (対話型モード)。 .RS 4
.TP 3 指定されたスクリプトを評価します。このオプションを使用すれば、コマンドラインにすべてが指定された1行スクリプトを実行できます。
\-help\ .RE
ヘルプメッセージを出力して終了します。 .PP
.TP 3 \-encoding \fIencoding\fR
\-?\ .RS 4
ヘルプメッセージを出力して終了します。 スクリプト・ファイルの読取り時に使用する文字エンコーディングを指定します。
.TP 3 .RE
\-q\ .PP
利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。 \-f \fIscript\-file\fR
.RS 4
指定されたスクリプト・ファイル(バッチ・モード)を評価します。
.RE
.PP
\-f \-
.RS 4
標準入力からスクリプトを読み取り、それを評価します(対話型モード)。
.RE
.PP
\-help
.RS 4
ヘルプ・メッセージを表示して終了します。
.RE
.PP
\-?
.RS 4
ヘルプ・メッセージを表示して終了します。
.RE
.PP
\-q
.RS 4
利用可能なすべてのスクリプト・エンジンを一覧表示したあと、終了します。
.RE .RE
.LP
.SH "引数" .SH "引数"
.LP .PP
.LP argumentsが存在していて、かつ\fI\-e\fR、\fI\-f\fRのいずれのオプションも使用されなかった場合、最初の引数がスクリプト・ファイルとなり、他の引数が存在する場合はスクリプトに渡されます。argumentsと、\fI\-e\fRまたは\fI\-f\fRオプションが使用されている場合、すべてのargumentsがスクリプトに渡されます。arguments、\fI\-e\fR、\fI\-f\fRがどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、\fIarguments\fRという名前の\fIString\fR配列型のエンジン変数を使用します。
[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] と、\f3\-e\fP または \f3\-f\fP が使用されている場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
.LP
.SH "例" .SH "例"
.LP .SS "インライン・スクリプトの実行"
.SS .sp
インラインスクリプトの実行 .if n \{\
.LP .RS 4
.\}
.nf .nf
\f3 jrunscript \-e "print(\*(Aqhello world\*(Aq)"
.fl jrunscript \-e "cat(\*(Aqhttp://www\&.example\&.com\*(Aq)"
jrunscript \-e "print('hello world')"
.fl
jrunscript \-e "cat('http://java.sun.com')"
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.SS .\}
指定された言語を使用し、指定されたスクリプトファイルを評価する .SS "指定された言語の使用およびスクリプト・ファイルの評価"
.LP .sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 jrunscript \-l js \-f test\&.js
.fl
jrunscript \-l js \-f test.js
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.SS .\}
対話型モード .SS "対話型モード"
.LP .sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3
.fl
jrunscript jrunscript
.fl js> print(\*(AqHello World\en\*(Aq);
js> print('Hello World\\n');
.fl
Hello World Hello World
.fl
js> 34 + 55 js> 34 + 55
.fl 89\&.0
89.0 js> t = new java\&.lang\&.Thread(function() { print(\*(AqHello World\en\*(Aq); })
.fl
js> t = new java.lang.Thread(function() { print('Hello World\\n'); })
.fl
Thread[Thread\-0,5,main] Thread[Thread\-0,5,main]
.fl js> t\&.start()
js> t.start()
.fl
js> Hello World js> Hello World
.fl
.fl
js>
.fl
\fP
.fi
.LP
.SS
スクリプト引数を指定してスクリプトファイルを実行する
.LP
.nf
\f3
.fl
jrunscript test.js arg1 arg2 arg3
.fl
\fP
.fi
.LP
test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
.SH "関連項目"
.LP
.LP
JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
.LP
js>
.fi
.if n \{\
.RE
.\}
.SS "スクリプト引数を指定したスクリプト・ファイルの実行"
.PP
test\&.jsファイルはスクリプト・ファイルです。\fIarg1\fR、\fIarg2\fRおよび\fIarg3\fRの各引数がスクリプトに渡されます。スクリプトはarguments配列を使用してこれらの引数にアクセスできます。
.sp
.if n \{\
.RS 4
.\}
.nf
jrunscript test\&.js arg1 arg2 arg3
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.PP
JavaScriptが使用される場合、ユーザー定義スクリプトを評価する前に、\fIjrunscript\fRコマンドはいくつかの組込み関数や組込みオブジェクトを初期化します。これらのJavaScriptの組込みについては、http://code\&.google\&.com/p/jsdoc\-toolkit/にある
JsDoc\-Toolkitを参照してください。
.br
'pl 8.5i
'bp

291
jdk/src/linux/doc/man/ja/jsadebugd.1
View File

@ -1,142 +1,171 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jsadebugd
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: トラブルシューティング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jsadebugd 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jsadebugd \- サービスアビリティーエージェントデバッグデーモン .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jsadebugd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
関連項目 .el .ds Aq '
.RE .\" -----------------------------------------------------------------
.\" * set default formatting
.LP .\" -----------------------------------------------------------------
.SH "形式" .\" disable hyphenation
.LP .nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
jsadebugd \- Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。このコマンドは試験的なもので、サポートされていません。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ]
.fl
\fP\f3jsadebugd\fP pid [ server\-id ]
.fl
\f3jsadebugd\fP executable core [ server\-id ]
.fl
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.RS 3
.TP 3
pid
デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。
.RE .RE
.\}
.LP .sp
.RS 3 .if n \{\
.TP 3 .RS 4
executable .\}
.nf
\fIjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ]
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
.RS 3 \fIpid\fR
.TP 3 .RS 4
コアダンプの作成元になる Java 実行可能ファイルです。 デバッグ・サーバーが接続するプロセスのプロセスIDです。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)コマンドを使用します。単一のプロセスに接続できるデバッグ・サーバーのインスタンスは、1つに制限されます。
.RE .RE
.PP
.LP \fI実行可能ファイル\fR
.RS 3 .RS 4
.TP 3 コア・ダンプの作成元のJava実行可能ファイル。
core
デバッグサーバーを接続するコアファイルです。
.RE .RE
.PP
.LP \fIコア\fR
.RS 3 .RS 4
.TP 3 デバッグ・サーバーを接続するコア・ファイルです。
server\-id .RE
複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。 .PP
\fIserver\-id\fR
.RS 4
複数のデバッグ・サーバーが同一のマシン上で実行されている場合に必要になる、オプションの一意のIDです。このIDは、リモート・クライアントが、接続先のデバッグ・サーバーを特定するために使用する必要があります。このIDは、単一のマシン内で一意にする必要があります。
.RE .RE
.LP
.SH "ÀâÌÀ" .SH "ÀâÌÀ"
.LP .PP
.LP \fIjsadebugd\fRコマンドは、Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。\fIjstack\fR、\fIjmap\fRおよび\fIjinfo\fRなどのリモート・クライアントは、Java Remote Method Invocation (RMI)を使用しているサーバーに接続できます。\fIjsadebugd\fRコマンドを起動する前に、\fIrmiregistry\fRコマンドでRMIレジストリを次のように起動します。\fI$JAVA_HOME\fRはJDKのインストール・ディレクトリです。
\f3jsadebugd\fP は、Java プロセスまたはコアファイルに接続し、デバッグサーバーとして機能します。jstack(1)、jmap(1)、および jinfo(1) などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用しているサーバーに接続できます。 \f2jsadebugd\fP を起動する前に、次のようにして .sp
.na .if n \{\
\f2rmiregistry\fP @ .RS 4
.fi .\}
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi を起動する必要があります。
.LP
.nf .nf
\f3 rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar
.fl
\fP\f4rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar\fP\f3
.fl
\fP
.fi .fi
.if n \{\
.LP
.LP
ここで、 \f2$JAVA_HOME\fP は JDK インストールディレクトリです。rmiregistry が起動していない場合、jsadebugd は標準 (1099) ポートの rmiregistry を内部で起動します。デバッグサーバーは、SIGINT を送信する (Ctrl+C を押す) ことにより停止できます。
.LP
.LP
\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
.LP
.LP
次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
jinfo(1)
.TP 2
o
jmap(1)
.TP 2
o
jps(1)
.TP 2
o
jstack(1)
.TP 2
o
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
.RE .RE
.\}
.LP .PP
RMIレジストリが起動していない場合、\fIjsadebugd\fRコマンドはRMIレジストリを標準(1099)ポートで内部で起動します。デバッグ・サーバーは、\fISIGINT\fRを送信することにより停止できます。SIGINTを送信するには、\fB[Ctrl] + [C]\fRを押します。
.PP
\fB注意:\fR
このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。例:
\fIs\fR\fIet PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jinfo(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jmap(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jstack(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rmiregistry(1)
.RE
.br
'pl 8.5i
'bp

360
jdk/src/linux/doc/man/ja/jstack.1
View File

@ -1,172 +1,210 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jstack
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: トラブルシューティング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jstack 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jstack \- スタックトレース .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.br .\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.LP .\"
.RS 3 .pl 99999
.TP 2 .TH "jstack" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール"
o .\" -----------------------------------------------------------------
形式 .\" * Define some portability stuff
.TP 2 .\" -----------------------------------------------------------------
o .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
パラメータ .\" http://bugs.debian.org/507673
.br .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
説明 .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
オプション .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
関連項目 .\" disable justification (adjust text to left margin only)
.TP 2 .ad l
o .\" -----------------------------------------------------------------
既知のバグ .\" * MAIN CONTENT STARTS HERE *
.br .\" -----------------------------------------------------------------
.RE .SH "NAME"
jstack \- Javaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのスタック・トレースを出力します。このコマンドは試験的なもので、サポートされていません。
.LP .SH "概要"
.SH "形式" .sp
.LP .if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjstack\fR [ \fIoptions\fR ] \fIpid\fR
.fl
\fP\f3jstack\fP [ option ] pid
.fl
\f3jstack\fP [ option ] executable core
.fl
\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.LP
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。オプションを参照してください。
.LP
.RS 3
.TP 3
pid
印刷するスタックトレースのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE .RE
.\}
.LP .sp
.RS 3 .if n \{\
.TP 3 .RS 4
executable .\}
コアダンプの作成元の Java 実行可能ファイルです。 .nf
.br \fIjstack\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR
.TP 3 .fi
core .if n \{\
印刷するスタックトレースのコアファイルです。 .RE
.br .\}
.TP 3 .sp
remote\-hostname\-or\-IP .if n \{\
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。 .RS 4
.br .\}
.TP 3 .nf
server\-id \fIjstack\fR [ \fIoptions\fR ] [ \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。 .fi
.if n \{\
.RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.PP
\fIpid\fR
.RS 4
出力するスタック・トレースのプロセスIDです。プロセスはJavaプロセスである必要があります。マシン上で実行しているJavaプロセスの一覧を取得するには、jps(1)コマンドを使用します。
.RE
.PP
\fI実行可能ファイル\fR
.RS 4
コア・ダンプの作成元のJava実行可能ファイル。
.RE
.PP
\fIコア\fR
.RS 4
出力するスタック・トレースのコア・ファイルです。
.RE
.PP
\fIremote\-hostname\-or\-IP\fR
.RS 4
リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。
.RE
.PP
\fIserver\-id\fR
.RS 4
複数のデバッグ・サーバーが同一のリモート・ホストで実行している場合の、オプション固有のID。
.RE .RE
.LP
.SH "説明" .SH "説明"
.LP .PP
.LP \fIjstack\fRコマンドは、指定されたJavaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのJavaスタック・トレースを出力します。Javaフレームごとに、フルクラス名、メソッド名、バイトコード・インデックス(bci)、および行番号(利用可能な場合)が出力されます。\fI\-m\fRオプションを使用すると、\fIjstack\fRコマンドは、すべてのスレッドのJavaフレームとネイティブ・フレームの両方を、プログラム・カウンタ(PC)とともに出力します。ネイティブ・フレームごとに、PCに最も近いネイティブ・シンボル(利用可能な場合)が出力されます。C++分解名は分解解除されません。C++名を分解解除するには、このコマンドの出力を\fIc++filt\fRにパイプします。指定されたプロセスが64ビットJava仮想マシン上で実行されている場合は、\fI\-J\-d64\fRオプションを指定する必要があります(例:
\f3jstack\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーに対する Java スレッドの Java スタックトレースを印刷します。Java フレームごとに、フルクラス名、メソッド名、「bci」(バイトコードインデックス)、および行番号 (利用可能な場合) が印刷されます。\-m オプションを使用すると、jstack は、すべてのスレッドの Java フレームとネイティブフレームの両方を、「pc」(プログラムカウンタ) とともに印刷します。ネイティブフレームごとに、「pc」にもっとも近いネイティブシンボル (利用可能な場合) が印刷されます。C++ 分解名は分解解除されません。C++ 名を分解解除するには、このコマンドの出力を \f3c++filt\fP にパイプします。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。 \fIjstack \-J\-d64 \-m pid\fR)。
.br .PP
\fB注意\fR
.LP このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。dbgeng\&.dllファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。また、\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 set PATH=<jdk>\ejre\ebin\eclient;%PATH%
.fl
jstack \-J\-d64 \-m pid
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
\f3注\fP \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。dbgeng.dll が存在していない Windows システムでは、「Debugging Tools For Windows」をインストールしないとこれらのツールが正常に動作しません。また、 \f2PATH\fP 環境変数には、ターゲットプロセスによって使用される \f2jvm.dll\fP の場所、またはクラッシュダンプファイルが生成された場所が含まれるようにしてください。
.LP
.LP
次に例を示します。 \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-F
.TP 3 .RS 4
\-F \fIjstack\fR
「jstack [\-l] pid」が応答しない場合にスタックダンプを強制します。 [\fI\-l\fR]
.TP 3 \fIpid\fRが応答しない場合にスタック・ダンプを強制します。
\-l
長形式のリスト。所有 java.util.concurrent の
.na
\f2所有できるシンクロナイザ\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。
.TP 3
\-m
混合モード (Java およびネイティブ C/C++ フレームの両方) のスタックトレースを印刷します。
.TP 3
\-h
ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
ヘルプメッセージを出力します。
.br
.RE .RE
.PP
.LP \-l
.RS 4
長形式のリスト。所有\fIjava\&.util\&.concurrent\fRの所有できるシンクロナイザの一覧など、ロックについての追加情報を印刷します。http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.htmlにある
\fIAbstractOwnableSynchronizer\fRクラス記述を参照してください
.RE
.PP
\-m
.RS 4
JavaおよびネイティブC/C++フレームの両方を持つ混合モードのスタック・トレースを出力します。
.RE
.PP
\-h
.RS 4
ヘルプ・メッセージが出力されます。
.RE
.PP
\-help
.RS 4
ヘルプ・メッセージが出力されます。
.RE
.SH "既知の不具合"
.PP
混合モードのスタック・トレースでは、\fI\-m\fRオプションはリモート・デバッグ・サーバーでは機能しません。
.SH "関連項目" .SH "関連項目"
.LP .sp
.RS 3 .RS 4
.TP 2 .ie n \{\
o \h'-04'\(bu\h'+03'\c
pstack(1) .\}
.TP 2 .el \{\
o .sp -1
c++filt(1) .IP \(bu 2.3
.TP 2 .\}
o pstack(1)
jps(1)
.TP 2
o
jsadebugd(1)
.RE .RE
.sp
.LP .RS 4
.SH "既知のバグ" .ie n \{\
.LP \h'-04'\(bu\h'+03'\c
.LP .\}
混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。 .el \{\
.LP .sp -1
.IP \(bu 2.3
.\}
C++filt(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jsadebugd(1)
.RE
.br
'pl 8.5i
'bp

6041
jdk/src/linux/doc/man/ja/jstat.1
View File

File diff suppressed because it is too large Load Diff

528
jdk/src/linux/doc/man/ja/jstatd.1
View File

@ -1,286 +1,268 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jstatd
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: モニタリング・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jstatd 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
jstatd \- 仮想マシン jstat デーモン .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jstatd" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
セキュリティー .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
リモートインタフェース .\" disable justification (adjust text to left margin only)
.TP 2 .ad l
o .\" -----------------------------------------------------------------
例 .\" * MAIN CONTENT STARTS HERE *
.TP 2 .\" -----------------------------------------------------------------
o .SH "NAME"
関連項目 jstatd \- Java仮想マシン(JVM)をモニターし、リモート・モニタリング・ツールがJVMに接続できるようにします。このコマンドは試験的なもので、サポートされていません。
.RE .SH "概要"
.sp
.LP .if n \{\
.SH "形式" .RS 4
.LP .\}
.nf .nf
\f3 \fIjstatd\fR [ \fIoptions\fR ]
.fl
jstatd [ \fP\f4options\fP\f3 ]\fP
.br
\f3
.fl
\fP
.fi .fi
.if n \{\
.LP
.SH "パラメータ"
.LP
.RS 3
.TP 3
options
コマンド行オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。
.RE .RE
.\}
.LP .PP
.SH " 説明" \fIoptions\fR
.LP .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
\f3jstatd\fP ツールは、計測された HotSpot Java 仮想マシン (JVM) の作成と終了を監視し、ローカルシステム上で実行している Java 仮想マシンに、リモート監視ツールが接続できるようにするためのインタフェースを提供する RMI サーバーアプリケーションです。 .RE
.LP .SH "説明"
.LP .PP
\f3jstatd\fP サーバーでは、ローカルホストに RMI レジストリが存在することが必要になります。\f3jstatd\fP サーバーは、デフォルトポートまたは \f2\-p port\fP オプションで指定されたポート上の RMI レジストリに接続しようとします。RMI レジストリが見つからない場合、\f2\-p port\fP オプションで指定されたポート、または \f2\-p port\fP が省略されている場合は、デフォルト RMI レジストリにバインドされた \f3jstatd\fP アプリケーション内に、1 つの RMI レジストリが作成されます。内部 RMI レジストリの作成は、\f2\-nr\fP オプションを指定することによって禁止することができます。 \fIjstatd\fRコマンドは、計測されたJava HotSpot VMの作成と終了をモニターし、ローカル・システム上で実行されているJVMに、リモート・モニタリング・ツールが接続できるようにするためのインタフェースを提供するRMIサーバー・アプリケーションです。
.LP .PP
.LP \fIjstatd\fRサーバーでは、ローカル・ホストにRMIレジストリが必要になります。\fIjstatd\fRサーバーはデフォルト・ポートで、または\fI\-p\fR
\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。 \fIport\fRオプションで指定したポートで、RMIレジストリに接続しようとします。RMIレジストリが見つからない場合、\fI\-p\fR
.LP \fIport\fRオプションで指定されたポート、または\fI\-p\fR
\fIport\fRオプションが省略されている場合は、デフォルトRMIレジストリにバインドされた\fIjstatd\fRアプリケーション内に、1つのRMIレジストリが作成されます。内部RMIレジストリの作成は、\fI\-nr\fRオプションを指定することによって中止できます。
.SH "オプション" .SH "オプション"
.LP .PP
.LP \-nr
\f3jstatd\fP コマンドは次のオプションをサポートしています。 .RS 4
.LP 既存のRMIレジストリが見つからない場合、\fIjstatd\fRプロセス内に内部RMIレジストリを作成しないようにします。
.RS 3
.TP 3
\-nr
既存の RMI レジストリが見つからない場合、\f2jstatd\fP プロセス内に内部 RMI レジストリを作成しないようにします。
.TP 3
\-p\ port
RMI レジストリがあると予想されるポート番号です。 見つからない場合は、\f2\-nr\fP が指定されていなければ作成されます。
.TP 3
\-n\ rminame
RMI レジストリにおいて、リモート RMI オブジェクトがバインドされる名前です。デフォルト名は \f2JStatRemoteHost\fP です。複数の \f3jstatd\fP サーバーが同じホスト上で起動している場合、各サーバーのエクスポートした RMI オブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、監視クライアントの \f2hostid\fP および \f2vmid\fP 文字列に、その一意のサーバー名を含める必要があります。
.TP 3
\-Joption
\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE .RE
.PP
.LP \-p \fIport\fR
.SH "セキュリティー" .RS 4
.LP RMIレジストリがあると予想されるポート番号です。見つからない場合は、\fI\-nr\fRオプションが指定されていなければ作成されます。
.LP .RE
\f3jstatd\fP サーバーは、有効なネイティブアクセス権を持つ JVM だけを監視できます。したがって、\f3jstatd\fP プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。一部のユーザー資格は、UNIX(TM) ベースのシステムにおける \f2root\fP ユーザーのように、システム上の任意の JVM によってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行している \f3jstatd\fP プロセスは、システム上のすべての JVM を監視できますが、セキュリティー上の別の問題が起こります。 .PP
.LP \-n \fIrminame\fR
.LP .RS 4
\f3jstatd\fP サーバーは、リモートクライアントの認証を一切与えません。そのため、\f3jstatd\fP サーバープロセスを実行すると、\f3jstatd\fP プロセスがアクセス権を持つすべての JVM によるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境的に望ましくない場合があります。 特に実稼働環境または安全でないネットワークでは、\f3jstatd\fP プロセスを起動する前に、ローカルセキュリティーポリシーを検討する必要があります。 RMIレジストリにおいて、リモートRMIオブジェクトがバインドされる名前です。デフォルト名は\fIJStatRemoteHost\fRです。複数の\fIjstatd\fRサーバーが同じホスト上で起動している場合、各サーバーのエクスポートしたRMIオブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、モニタリング・クライアントの\fIhostid\fRおよび\fIvmid\fR文字列に、その一意のサーバー名を含める必要があります。
.LP .RE
.LP .PP
\f3jstatd\fP サーバーは、他のセキュリティーマネージャーがインストールされていない場合には、RMISecurityPolicy のインスタンスをインストールします。 そのため、セキュリティーポリシーファイルを指定する必要があります。ポリシーファイルは、デフォルトポリシー実装の \-J\fIoption\fR
.na .RS 4
\f2ポリシーファイルの構文\fP @ JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fIオプション\fRを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.fi .RE
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。 .SH "セキュリティ"
.LP .PP
.LP \fIjstatd\fRサーバーは、適切なネイティブ・アクセス権を持つJVMのみを監視できます。したがって、\fIjstatd\fRプロセスは、ターゲットJVMと同じユーザー資格で実行されている必要があります。UNIXベースのシステムにおけるrootユーザーなどの一部のユーザー資格は、システム上の任意のJVMによってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行されている\fIjstatd\fRプロセスは、システム上のすべてのJVMを監視できますが、セキュリティ上の別の問題が起こります。
次のポリシーファイルの場合、\f3jstatd\fP サーバーは一切のセキュリティー例外を使用せずに実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度は低いですが、\f3jstatd\fP サーバーを実行するために最低限必要なアクセス権しか認めないポリシーよりも自由度は高くなっています。 .PP
.LP \fIjstatd\fRサーバーには、リモート・クライアントの認証機能がありません。そのため、\fIjstatd\fRサーバー・プロセスを実行すると、\fIjstatd\fRプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に実稼働環境または安全でないネットワークでは、\fIjstatd\fRプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。
.PP
\fIjstatd\fRサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、\fIRMISecurityPolicy\fRのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある
「デフォルトのPolicyの実装とポリシー・ファイルの構文」に準拠している必要があります
.PP
次のポリシー・ファイルでは、セキュリティ例外を発生せずに\fIjstatd\fRサーバーを実行できます。このポリシーは、すべてのコード・ベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\fIjstatd\fRサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 grant codebase "file:${java\&.home}/\&.\&./lib/tools\&.jar" {
.fl permission java\&.security\&.AllPermission;
grant codebase "file:${java.home}/../lib/tools.jar" {\fP };
.br
\f3
.fl
permission java.security.AllPermission;\fP
.br
\f3
.fl
};\fP
.br
\f3
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
このポリシーを使用するには、このテキストを \f2jstatd.all.policy\fP というファイルにコピーし、次のように \f3jstatd\fP サーバーを実行します。 .PP
.LP このポリシー設定を使用するには、このテキストを\fIjstatd\&.all\&.policy\fRというファイルにコピーし、次のように\fIjstatd\fRサーバーを実行します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 jstatd \-J\-Djava\&.security\&.policy=jstatd\&.all\&.policy
.fl
jstatd \-J\-Djava.security.policy=jstatd.all.policy\fP
.br
\f3
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
より厳しいセキュリティーを実施するサイトの場合、カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。 ただし、このような方法は、IP アドレスの盗聴攻撃を受けやすくなります。セキュリティーの問題について、カスタマイズしたポリシーファイルでも対処できない場合は、\f3jstatd\fP サーバーを実行せずに、\f3jstat\fP と \f3jps\fP ツールをローカルで使用することがもっとも安全な方法になります。 .PP
.LP より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\fIjstatd\fRサーバーを実行せずに、\fIjstat\fRと\fIjps\fRツールをローカルで使用することが最も安全な方法になります。
.SH "リモートインタフェース" .SH "リモート・インタフェース"
.LP .PP
.LP \fIjstatd\fRプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。
\f3jstatd\fP プロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書き込みを行わないでください。
.LP
.SH "例" .SH "例"
.LP .PP
.LP 次に、\fIjstatd\fRコマンドの例を示します。\fIjstatd\fRスクリプトによって、サーバーはバックグラウンドで自動的に起動します。
次に \f3jstatd\fP を起動する例を紹介します。\f3jstatd\fP スクリプトによって、サーバーはバックグラウンドで自動的に起動します。 .SS "内部RMIレジストリ"
.LP .PP
.SS この例は、内部RMIレジストリを使用したホストによる\fIjstatd\fRセッションの起動を表しています。この例では、デフォルトのRMIレジストリ・ポート(ポート1099)には、他のサーバーはバインドされていないと想定しています。
内部 RMI レジストリの使用 .sp
.LP .if n \{\
.LP .RS 4
この例は、内部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。この例では、デフォルトの RMI レジストリポート (ポート 1099) には、他のサーバーはバインドされていないと想定しています。 .\}
.LP
.nf .nf
\f3 jstatd \-J\-Djava\&.security\&.policy=all\&.policy
.fl
jstatd \-J\-Djava.security.policy=all.policy
.fl
\fP
.fi .fi
.if n \{\
.LP
.SS
外部 RMI レジストリの使用
.LP
.LP
この例は、外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
.fl
rmiregistry&
.fl
jstatd \-J\-Djava.security.policy=all.policy
.fl
\fP
.fi
.LP
.LP
この例は、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
.fl
rmiregistry 2020&
.fl
jstatd \-J\-Djava.security.policy=all.policy \-p 2020
.fl
\fP
.fi
.LP
.LP
この例は、AlternateJstatdServerName の名前にバインドされた、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
.fl
rmiregistry 2020&
.fl
jstatd \-J\-Djava.security.policy=all.policy \-p 2020 \-n AlternateJstatdServerName
.fl
\fP
.fi
.LP
.SS
インプロセス RMI レジストリの作成の禁止
.LP
.LP
この例は、RMI レジストリが見つからない場合に RMI レジストリを作成しない \f3jstatd\fP の起動を表しています。この例では、RMI レジストリがすでに実行していると想定しています。実行していない場合は、該当するエラーメッセージが表示されます。
.LP
.nf
\f3
.fl
jstatd \-J\-Djava.security.policy=all.policy \-nr
.fl
\fP
.fi
.LP
.SS
RMI ログ機能の有効化
.LP
.LP
この例は、RMI ログ機能を有効にした \f3jstatd\fP の起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。
.LP
.nf
\f3
.fl
jstatd \-J\-Djava.security.policy=all.policy \-J\-Djava.rmi.server.logCalls=true
.fl
\fP
.fi
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
「jps(1) \- Java 仮想マシンプロセスステータスツール」
.TP 2
o
「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
「
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java リモートオブジェクトレジストリ」
.RE .RE
.\}
.LP .SS "外部RMIレジストリ"
.PP
この例は、外部RMIレジストリを使用した\fIjstatd\fRセッションの起動を表しています。
.sp
.if n \{\
.RS 4
.\}
.nf
rmiregistry&
jstatd \-J\-Djava\&.security\&.policy=all\&.policy
.fi
.if n \{\
.RE
.\}
.PP
この例では、ポート2020の外部RMIレジストリを使用して\fIjstatd\fRセッションを起動します。
.sp
.if n \{\
.RS 4
.\}
.nf
jrmiregistry 2020&
jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020
.fi
.if n \{\
.RE
.\}
.PP
この例では、ポート2020の外部RMIレジストリを使用して、\fIAlternateJstatdServerName\fRにバインドされている\fIjstatd\fRセッションを起動します。
.sp
.if n \{\
.RS 4
.\}
.nf
rmiregistry 2020&
jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020
\-n AlternateJstatdServerName
.fi
.if n \{\
.RE
.\}
.SS "インプロセスRMIレジストリの作成の停止"
.PP
この例では、外部RMIレジストリがない場合に作成しない\fIjstatd\fRセッションを起動します。この例では、RMIレジストリがすでに実行されていると想定しています。RMIレジストリが実行されていない場合、エラー・メッセージが表示されます。
.sp
.if n \{\
.RS 4
.\}
.nf
jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-nr
.fi
.if n \{\
.RE
.\}
.SS "RMIロギングの有効化"
.PP
この例では、RMIロギング機能を有効化して\fIjstatd\fRセッションを起動します。この方法は、トラブルシューティングまたはサーバー活動のモニタリングに役立ちます。
.sp
.if n \{\
.RS 4
.\}
.nf
jstatd \-J\-Djava\&.security\&.policy=all\&.policy
\-J\-Djava\&.rmi\&.server\&.logCalls=true
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jstat(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rmiregistry(1)
.RE
.br
'pl 8.5i
'bp

237
jdk/src/linux/doc/man/ja/jvisualvm.1
View File

@ -1,126 +1,123 @@
." Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: jvisualvm
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH jvisualvm 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
\f2jvisualvm\fP \- Java 仮想マシンの監視、トラブルシューティング、およびプロファイリングツール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "jvisualvm" "1" "2013年11月21日" "JDK 8" "Javaトラブルシューティング、プロファイリング、モニタリン"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
パラメータ .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
説明 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
オプション .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
使用方法 .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
関連項目 .\" disable justification (adjust text to left margin only)
.RE .ad l
.\" -----------------------------------------------------------------
.LP .\" * MAIN CONTENT STARTS HERE *
.SH "形式" .\" -----------------------------------------------------------------
.LP .SH "NAME"
jvisualvm \- Javaアプリケーションを視覚的に監視、トラブルシュートおよびプロファイルします。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIjvisualvm\fR [ \fIoptions\fR ]
.fl
\fP\f3jvisualvm\fP [ \f2options\fP ]
.fl
.fi .fi
.if n \{\
.LP .RE
.SH "パラメータ" .\}
.LP .PP
.LP \fIoptions\fR
オプションを使用する場合、コマンド名の直後に記述してください。オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、このあとの「オプション」を参照してください。 .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
.SH " 説明" .RE
.LP .SH "説明"
.LP .PP
Java VisualVM は、指定された Java 仮想マシン (JVM(*)) で Java テクノロジベースのアプリケーション (Java アプリケーション) が実行されているときに、その Java アプリケーションに関する詳細な情報を提供する直感的なグラフィカルユーザーインタフェースです。Java VisualVM という名前は、Java VisualVM が JVM ソフトウェアに関する情報を「視覚的に」提供するという事実に由来しています。 Java VisualVMは、指定されたJava仮想マシン(JVM)でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を視覚的に提供するという事実に由来しています。
.LP .PP
.LP Java VisualVMは、いくつかのモニタリング、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\fIjmap\fR、\fIjinfo\fR、\fIjstat\fRおよび\fIjstack\fRで提供されている機能のほとんどが、Java VisualVMに組み込まれています。\fIjconsole\fRコマンドによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。
Java VisualVM は、いくつかの監視、トラブルシューティング、およびプロファイリングユーティリティーを 1 つのツールに統合します。たとえば、スタンドアロンツール \f2jmap\fP、 \f2jinfo\fP、 \f2jstat\fP 、および \f2jstack\fP で提供されている機能のほとんどが、Java VisualVM に組み込まれています。JConsole ツールによって提供される一部の機能など、ほかの機能はオプションのプラグインとして追加できます。 .PP
.LP Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行および監視、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。プラグインでJava VisualVMの機能を拡張できます。たとえば、\fIjconsole\fRコマンドのほとんどの機能は、「MBean」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの\fB「ツール」\fR、\fB「プラグイン」\fRを選択します。
.PP
Java VisualVMを起動するには、次のコマンドを実行します。
.sp
.if n \{\
.RS 4
.\}
.nf
% jvisualvm <options>
.fi
.if n \{\
.RE
.\}
.SH "オプション" .SH "オプション"
.LP .PP
.LP 次のオプションは、Java VisualVMを起動したときに実行可能になります。
次のオプションは、Java VisualVM を起動したときに実行可能になります。 .PP
.LP \-J\fIjvm_option\fR
.RS 3 .RS 4
.TP 3 この\fIjvm_option\fRをJVMソフトウェアに渡します。
\-J<jvm_option>\
この \f2<jvm_option>\fP を JVM ソフトウェアに渡します。
.RE .RE
.LP
.SH "使用方法"
.LP
.LP
Java VisualVM は、Java アプリケーションの開発者がアプリケーションのトラブルシューティングを行なったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVM を使用すると、開発者はヒープダンプの生成および解析、メモリーリークの特定、ガベージコレクションの実行および監視、およびメモリーと CPU の簡易プロファイリングの実行が可能になります。Java VisualVM の機能を拡張するプラグインもいくつかあります。たとえば、JConsole ツールのほとんどの機能は、MBeans タブおよび JConsole Plug\-in Wrapper プラグインを介して使用できます。標準の Java VisualVM プラグインのカタログから選択するには、Java VisualVM メニューの「ツール」>「プラグイン」を選択します。
.LP
.LP
Java VisualVM を起動するには、次のコマンドを実行します。
.LP
.nf
\f3
.fl
% jvisualvm \fP\f4<options>\fP\f3
.fl
\fP
.fi
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.LP .RS 4
Java VisualVM の詳細は、次のページを参照してください。 .ie n \{\
.LP \h'-04'\(bu\h'+03'\c
.RS 3 .\}
.TP 2 .el \{\
o .sp -1
.na .IP \(bu 2.3
\f2Java VisualVM 開発者のサイト\fP @ .\}
.fi Java VisualVM開発者のサイト
http://visualvm.java.net http://visualvm\&.java\&.net/
.TP 2
o
.na
\f2Java SE プラットフォームでの Java VisualVM のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/visualvm/index.html
.RE .RE
.sp
.LP .RS 4
.LP .ie n \{\
\f2(* 「Java 仮想マシン」と「JVM」という用語は、Java プラットフォームの仮想マシンを意味しています。)\fP \h'-04'\(bu\h'+03'\c
.LP .\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Java SEドキュメントのJava VisualVM
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/visualvm/index\&.html)
.RE
.br
'pl 8.5i
'bp

3368
jdk/src/linux/doc/man/ja/keytool.1
View File

File diff suppressed because it is too large Load Diff

164
jdk/src/linux/doc/man/ja/native2ascii.1
View File

@ -1,72 +1,98 @@
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: native2ascii
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: 国際化ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH native2ascii 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
native2ascii \- ネイティブ \- ASCII コンバータ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
サポートされる文字エンコーディングの文字のファイルを ASCII または Unicode エスケープあるいはその両方のファイルに変換します。その逆の変換も行います。 .\"
.LP .pl 99999
.SH "形式" .TH "native2ascii" "1" "2013年11月21日" "JDK 8" "国際化ツール"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
native2ascii \- サポートされている任意の文字エンコーディングの文字を含むファイルを、ASCIIおよびUnicodeでエスケープされたファイルに変換して(またはその逆)、ローカライズ可能なアプリケーションを作成します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fInative2ascii\fR [ \fIinputfile\fR ] [ \fIoutputfile\fR ]
.fl
\fP\f4native2ascii\fP\f2 [options] [inputfile [outputfile]]\fP
.fl
.fi .fi
.if n \{\
.LP
.SH "説明"
.LP
.LP
\f2native2ascii\fP Java 実行環境でサポートされる文字エンコーディングにエンコードされたファイルを、ASCII でエンコードされたファイルに変換します。ASCII 文字セットの一部でないすべての文字で Unicode エスケープ (「\\uxxxx」の表記) を使用します。このプロセスは、ISO\-8859\-1 文字セットに含まれない文字が含まれているプロパティーファイルで必要です。このツールは、その逆の変換を実行することもできます。
.LP
.LP
\f2outputfile\fP を省略した場合、標準出力に出力されます。さらに、 \f2inputfile\fP を省略した場合、標準入力から入力されます。
.LP
.SH "オプション"
.LP
.RS 3
.TP 3
\-reverse
逆の処理を行います。つまり、ISO\-8859\-1 で Unicode エスケープを使ってエンコードされたファイルを、Java 実行環境でサポートされる文字エンコーディングのファイルに変換します。
.br
.br
.TP 3
\-encoding encoding_name
変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング ( \f2java.nio.charset.Charset.defaultCharset\fP メソッドで定義される) が使用されます。 \f2encoding_name\fP 文字列は、
.na
\f4「サポートされている文字列エンコーディング」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlドキュメントに示されている、Java 実行環境でサポートされる文字エンコーディングの名前にする必要があります。
.br
.br
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE .RE
.\}
.LP .PP
\fIinputfile\fR
.RS 4
ASCIIに変換するエンコードされたファイル。
.RE
.PP
\fIoutputfile\fR
.RS 4
変換されたASCIIファイル。
.RE
.SH "説明"
.PP
\fInative2ascii\fRコマンドは、ASCIIキャラクタ・セットに含まれないすべての文字にUnicodeエスケープ(\fI\eu\fR\fIxxxx\fR)表記法を使用して、Java Runtime Environment (JRE)でサポートされているエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。
.PP
\fIoutputfile\fR値を省略した場合、標準出力に出力されます。さらに、\fIinputfile\fR値を省略した場合、標準入力から入力されます。
.SH "オプション"
.PP
\-reverse
.RS 4
逆の処理を行います。つまり、ISO\-8859\-1でUnicodeエスケープを使用してエンコードされたファイルを、JREでサポートされる文字エンコーディングのファイルに変換します。
.RE
.PP
\-encoding \fIencoding_name\fR
.RS 4
変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング(\fIjava\&.nio\&.charset\&.Charset\&.defaultCharset\fRメソッドで定義された)が使用されます。\fIencoding_name\fR文字列は、JREでサポートされている文字エンコーディングの名前にする必要があります。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/intl/encoding\&.doc\&.htmlにある
「サポートされているエンコーディング」を参照してください
.RE
.PP
\-J\fIoption\fR
.RS 4
Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE
.br
'pl 8.5i
'bp

597
jdk/src/linux/doc/man/ja/orbd.1
View File

@ -1,368 +1,277 @@
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: orbd
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java IDLおよびRMI-IIOPツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH orbd 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
orbd \- The Object Request Broker Daemon .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。 .\"
.LP .pl 99999
.LP .TH "orbd" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
\f3関連項目:\fP .\" -----------------------------------------------------------------
.na .\" * Define some portability stuff
\f2ネームサービス\fP @ .\" -----------------------------------------------------------------
.fi .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html .\" http://bugs.debian.org/507673
.LP .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.SH "形式" .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.LP .ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
orbd \- CORBA環境のサーバーにある永続オブジェクトをクライアントから検索して呼び出せるようにします。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIorbd\fR [ \fIoptions\fR ]
.fl
orbd <\fP\f3options\fP\f3>
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.SH "説明" .SH "説明"
.LP .PP
.LP \fIorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。
\f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。 .sp
.LP .RS 4
.RS 3 .ie n \{\
.TP 2 \h'-04'\(bu\h'+03'\c
o .\}
ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。 .el \{\
.TP 2 .sp -1
o .IP \(bu 2.3
クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる .\}
ネーミング・サービスにあるオブジェクト参照が、サーバーのライフ・サイクルと無関係になります。たとえば、オブジェクト参照は、初めてインストールされたときはネーミング・サービスのサーバーによってネーミング・サービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、呼び出したクライアントにORBDが正しいオブジェクト参照を返します。
.RE .RE
.sp
.LP .RS 4
.LP .ie n \{\
ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの「サーバーマネージャー」を参照してください。 \h'-04'\(bu\h'+03'\c
.LP .\}
.LP .el \{\
\f2orbd\fP を起動すると、ネームサービスも起動されます。ネームサービスについては、 .sp -1
.na .IP \(bu 2.3
\f2「ネームサービス」\fP @ .\}
.fi クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 .RE
.LP .PP
ORBDのサーバー・マネージャにアクセスするには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。
.PP
\fIorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。
.SH "オプション" .SH "オプション"
.LP .PP
.SS \-ORBInitialPort \fInameserverport\fR
必須オプション .RS 4
.LP 必須。ネーム・サーバーを起動するポートの番号を指定します。\fIorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。
.RS 3
.TP 3
\-ORBInitialPort nameserverport
ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。(必須)
.RE .RE
.SS "必須でないオプション"
.LP .PP
.LP \-port \fIport\fR
.RS 4
.LP ORBDを起動するポートを指定します。このポートで、永続オブジェクトに対するリクエストをORBDが受け取ります。このポートのデフォルト値は1049です。このポート番号は、永続Interoperable Object References (IOR)のポート・フィールドに追加されます。
.SS
その他のオプション
.LP
.RS 3
.TP 3
\-port port
ORBD を起動するポートを指定します。ORBD は、このポートで、持続オブジェクトに対する要求を受け取ります。このポートのデフォルト値は 1049 です。このポート番号が、持続 Interoperable Object References (IOR). のポートフィールドに追加されます。(省略可)
.RE .RE
.PP
.LP \-defaultdb \fIdirectory\fR
.RS 3 .RS 4
.TP 3 ORBD永続格納ディレクトリ\fIorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fI\&./orb\&.db\fRになります。
\-defaultdb directory
ORBD 持続格納ディレクトリ \f2orb.db\fP が作成されるベースディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は「./orb.db」となります。(省略可)
.RE .RE
.PP
.LP \-serverPollingTime \fImilliseconds\fR
.RS 3 .RS 4
.TP 3 \fIservertool\fRを使用して登録された永続サーバーのヘルス状態をORBDがチェックする間隔を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。
\-serverPollingTime milliseconds
\f2servertool\fP を使用して登録された持続サーバーが正常に動作していることを ORBD が確認する回数を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可)
.RE .RE
.PP
.LP \-serverStartupDelay milliseconds
.RS 3 .RS 4
.TP 3 \fIservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。
\-serverStartupDelay milliseconds
\f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可)
.RE .RE
.PP
.LP \-J\fIoption\fR
.RS 3 .RS 4
.TP 3 Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
\-Joption
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.TP 3
.RE .RE
.SS "ネーミング・サービスの起動と停止"
.LP .PP
.SH "ネームサービスの起動と停止" ネーミング・サービスは、CORBAオブジェクトにネーミングを可能にするCORBAサービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。ネーム・バインディングをネーミング・サービスに格納すれば、クライアントが名前を指定して目的のオブジェクト参照を取得できるようになります。
.LP .PP
.LP クライアントまたはサーバーを実行する前に、ORBDを起動します。ORBDには、永続ネーミング・サービスおよび一時ネーミング・サービスが組み込まれています。これらはどちらもCOSネーミング・サービスの実装です。
ネームサービスは、 .PP
.na 永続ネーミング・サービスは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーミング・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。
\f2CORBA オブジェクト\fP @ .PP
.fi 下位互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fItnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20objectにネーミングを可能にする CORBA サービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。 .PP
.na \fI\-ORBInitialPort\fR引数は、\fIorbd\fRの必須のコマンドライン引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。
\f2「ネームバインディング」\fP @ .PP
.fi UNIXコマンド・シェルで\fIorbd\fRを起動するには、次のように入力します。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingはネームサービスに格納され、クライアントは名前を与えて目的のオブジェクト参照を取得できます。 .sp
.LP .if n \{\
.LP .RS 4
ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。これらはどちらも COS ネームサービスの実装です。 .\}
.LP
.LP
\f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。
.LP
.LP
\
.LP
.LP
下位互換性のため、旧バージョンの JDK に同梱されていた\f2一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。
.LP
.LP
\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、JavaIDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。必要であれば別のポートに変更してください。
.LP
.LP
UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.nf .nf
\f3 orbd \-ORBInitialPort 1050&
.fl
orbd \-ORBInitialPort 1050&
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
Windows の MS\-DOS システムプロンプトでは、次のように入力します。 .PP
.LP WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 start orbd \-ORBInitialPort 1050
.fl
start orbd \-ORBInitialPort 1050
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。 .PP
.LP これでORBDが実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネーミング・サービスが実行されているポートの番号(必要な場合はさらにマシン名)を認識している必要があります。これを実現する1つの方法は、次のコードをアプリケーションに追加することです。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 Properties props = new Properties();
.fl props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");
Properties props = new Properties(); props\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost");
.fl ORB orb = ORB\&.init(args, props);
props.put("org.omg.CORBA.ORBInitialPort", "1050");
.fl
props.put("org.omg.CORBA.ORBInitialHost", "MyHost");
.fl
ORB orb = ORB.init(args, props);
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。 .PP
.LP この例では、ネーミング・サービスは、ホスト\fIMyHost\fRのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、\fIHelloApplication\fRを起動できます。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost
.fl
java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。たとえば、Solaris 上で \f2pkill orbd\fP \f2を実行したり、\fP \f2orbd\fP が動作中の DOS ウィンドウで Ctrl+C キーを押したりします。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。 .PP
.LP ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fIpkill\fR
.LP \fIorbd\fRを実行したり、\fIorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。
ORDB に含まれるネームサービスの詳細については、 .PP
.na ORBDに付属するネーミング・サービスの詳細は、
\f2「ネームサービス」\fP @ http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの「Naming Service」を参照してください
.fi .SH "サーバー・マネージャ"
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 .PP
.LP ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。\fIservertool\fRを使用してサーバーを起動する場合は、\fIorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。
.SH "サーバーマネージャー" .PP
.LP http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.htmlの
.LP 「Java IDL: The "Hello World" Example」を参照してください
ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合は、\f2orbd\fP が実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカルコンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 .PP
.LP この例では、チュートリアルの手順に従って\fIidlj\fRコンパイラと\fIjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。
.SS .PP
サーバーマネージャー: 例 \fIorbd\fRを起動します。
.LP .PP
.LP UNIXコマンド・シェルで次のように入力します:
デモ用の \fIorbd \-ORBInitialPort 1050\fR。
.na .PP
\f2サンプルチュートリアル\fP @ MS\-DOSシステム・プロンプト(Windows)で次のように入力します:
.fi \fIs\fR\fItart orbd \-ORBInitialPort 105\fR\fI0\fR
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.htmlを使用し、チュートリアルの手順に従って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラを実行します。サーバーマネージャーを実行するには、次の手順に従ってアプリケーションを実行します。 .PP
.LP ポート1050はネーム・サーバーを実行するポートです。\fI\-ORBInitialPort\fRオプションは必須コマンドライン引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。
.LP .PP
\f2orbd\fP を起動します。 \fIservertool\fRを起動します:
.LP \fIservertool \-ORBInitialPort 1050\fR。
.LP .PP
UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。 前回の手順とネーム・サーバー(\fIorbd\fR)のポートが同じであることを確認します。たとえば\fI\-ORBInitialPort 1050\&.\fRのようになります。\fIservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。
.LP .PP
.LP \fIservertool\fRコマンドライン・インタフェースで、\fIservertool\fRプロンプトから\fIHello\fRサーバーを起動します。
\ .sp
.LP .if n \{\
.RS 4
.\}
.nf .nf
\f3 servertool > register \-server HelloServer \-classpath \&. \-applicationName
.fl
orbd \-ORBInitialPort 1050
.fl
\fP
.fi
.LP
.LP
Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
.fl
start orbd \-ORBInitialPort 1050
.fl
\fP
.fi
.LP
.LP
\f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。
.LP
.LP
\f2servertool\fP を起動します。
.LP
.LP
Hello サーバーを起動するには、次のように入力します。
.LP
.nf
\f3
.fl
servertool \-ORBInitialPort 1050
.fl
\fP
.fi
.LP
.LP
前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。\f2servertool\fP は、ネームサーバーと同じポート上で起動する必要があります。
.LP
.LP
\f2servertool\fP コマンド行インタフェースが表示されます。
.LP
.LP
.LP
.LP
\f2servertool\fP プロンプトから Hello サーバーを起動します。
.LP
.nf
\f3
.fl
servertool > register \-server HelloServer \-classpath .\-applicationName
.fl
HelloServerApName HelloServerApName
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
\f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。 .PP
.LP \fIservertool\fRによってサーバーが登録されて、\fIHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。
.LP .sp
.if n \{\
.LP .RS 4
.LP .\}
別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。 .nf
.LP java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost
.LP .fi
\ .if n \{\
.LP .RE
.nf .\}
\f3 .PP
.fl この例の\fI\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fIHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fIORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fIorbd\fR)ポートを指定します(例:
java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost \fI\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fIorbd\fR)と\fIservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fIorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。
.fl .PP
\fP Oracle Solarisから\fIorbd\fRをシャットダウンするには、プロセスを検索して、\fIkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fIservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。
.fi .SH "関連項目"
.sp
.LP .RS 4
.LP .ie n \{\
この例の \f2\-ORBInitialHost localhost\fP は省略することができます。ネームサーバーが Hello クライアントとして同一ホスト上で動作しているからです。ネームサーバーが別のホストで動作している場合は、IDL ネームサーバーが動作しているホストを \f2\-ORBInitialHost\fP \f2nameserverhost\fP で指定します。 \h'-04'\(bu\h'+03'\c
.LP .\}
.LP .el \{\
前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。 .sp -1
.LP .IP \(bu 2.3
.LP .\}
\ servertool(1)
.LP .RE
.LP .sp
\ .RS 4
.LP .ie n \{\
.LP \h'-04'\(bu\h'+03'\c
サーバーマネージャーの操作が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を停止するか終了してください。 .\}
.LP .el \{\
.LP .sp -1
DOS プロンプトで \f2orbd\fP をシャットダウンするには、サーバーを実行しているウィンドウを選択して \f2Ctrl+C\fP と入力します。UNIX シェルで \f2orbd\fP をシャットダウンするには、プロセスを検出して終了 (kill) します。サーバーを明示的に停止するまでは、呼び出し待機状態が続きます。 .IP \(bu 2.3
.LP .\}
.LP http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの
\f2servertool\fP をシャットダウンするには、 \f2quit\fP と入力してキーボードの \f2Enter\fP キーを押します。 「Naming Service」
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
.na
\f2ネームサービス\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.br
.TP 2
o
servertool(1)
.RE .RE
.LP
.br .br
'pl 8.5i
.LP 'bp

667
jdk/src/linux/doc/man/ja/pack200.1
View File

@ -1,362 +1,325 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: pack200
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Javaデプロイメント・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH pack200 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
pack200 \- JAR パックツール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "pack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
説明 .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
オプション .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
終了ステータス .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
関連項目 .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
注意事項 .\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pack200 \- WebデプロイメントのためにJARファイルをpack200圧縮ファイルにパッケージします。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
.SH "形式" オプションは任意の順序で指定できます。コマンドラインまたはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP .PP
.LP \fIoptions\fR
\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
.LP
オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.TP 3
options
コマンド行オプション。
.TP 3
output\-file
出力ファイルの名前。
.TP 3
JAR\-file
入力ファイルの名前。
.RE .RE
.PP
.LP \fIoutput\-file\fR
.SH " 説明" .RS 4
.LP 出力ファイルの名前。
.LP .RE
\f2pack200\fP ツールは、Java gzip 圧縮プログラムを使用して JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する \f2Java アプリケーション\fP です。 \f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。 .PP
.LP \fIJAR\-file\fR
.LP .RS 4
\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。 入力ファイルの名前。
.LP .RE
.SS .SH "説明"
一般的な使用方法: .PP
.LP \fIpack200\fRコマンドは、Java gzipコンプレッサを使用してJARファイルをpack200圧縮ファイルに変換するJavaアプリケーションです。pack200ファイルは高圧縮のファイルで、直接デプロイでき、帯域幅の節約やダウンロード時間の短縮が可能です。
.LP .PP
\f2% pack200 myarchive.pack.gz myarchive.jar\fP \fIpack200\fRコマンドには、圧縮エンジンの設定や微調整を行うオプションがあります。一般的な使用方法を次の例に示します。\fImyarchive\&.pack\&.gz\fRがデフォルトの\fIpack200\fRコマンド設定で作成されます。
.LP .sp
.LP .if n \{\
この例では、 \f2デフォルトの pack200 設定を使用して\fP myarchive.pack.gz \f2が生成されます\fP 。 .RS 4
.LP .\}
.nf
pack200 myarchive\&.pack\&.gz myarchive\&.jar
.fi
.if n \{\
.RE
.\}
.SH "オプション" .SH "オプション"
.LP .PP
.LP \-r, \-\-repack
\f4\-r \-\-repack\fP .RS 4
.LP JARファイルをパックした後アンパックして、JARファイルを生成します。生成されたファイルは\fIjarsigner\fR(1)ツールの入力ファイルとして使用できます。次の例では、myarchive\&.jarファイルをパックした後、アンパックします。
.LP .sp
ファイル \f2myarchive.jar\fP をパックしたあとアンパックすることで、JAR ファイルを生成します。生成されたファイルは \f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。 .if n \{\
.LP .RS 4
.LP .\}
\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP .nf
.LP pack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar
.LP pack200 \-\-repack myarchive\&.jar
\f2% pack200 \-\-repack myarchive.jar\fP .fi
.LP .if n \{\
.LP
\f4\-g \-\-no\-gzip\fP
.LP
.LP
\f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
.LP
.LP
\f2% pack200 \-\-no\-gzip myarchive.pack myarchive.jar\fP
.LP
.LP
\f4\-G \-\-strip\-debug\fP
.LP
.LP
出力からデバッグ用の属性を削除します。そうした属性としては、 \f2SourceFile\fP、 \f2LineNumberTable\fP、 \f2LocalVariableTable\fP 、 \f2LocalVariableTypeTable\fP などが挙げられます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
.LP
.LP
\f4\-\-keep\-file\-order\fP
.LP
.LP
入力ファイル内のファイルの順序を維持します。これがデフォルトの動作です。
.LP
.LP
\f4\-O \-\-no\-keep\-file\-order\fP
.LP
.LP
パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
.LP
.LP
\f4\-Svalue \-\-segment\-limit=\fP\f2value\fP
.LP
.LP
この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。単一の入力ファイルの必要サイズが
.br
N バイトを超えると、そのファイルには独立したアーカイブセグメントが割り当てられます。特殊なケースとして、値が \f2\-1\fP の場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が \f20\fP の場合は、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。
.LP
.LP
各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前とほかの送信されるプロパティーのサイズを計算して推測されます。
.LP
.LP
デフォルトは \-1 です。つまり、パックツールは常に単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化 (分割) してより小さな JAR にすることを強くお勧めします。
.LP
.LP
この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
.LP
.LP
\f4\-Evalue \-\-effort=\fP\f2value\fP
.LP
.LP
単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合は、比較的短い圧縮時間でやや大きめのファイルが生成されますが、レベル \f29\fP の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。
.LP
.LP
デフォルトは \f25\fPです。この場合、標準的な時間で適切な圧縮が行われます。
.LP
.LP
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
.LP
.LP
デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。返される値は次のどれかになります。
.LP
.RS 3
.TP 3
true
.TP 3
false
どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。
.RE .RE
.\}
.LP 次の例では、入力ファイル内のファイルの順序を保持します。
.RS 3
.TP 3
keep
入力 JAR.内で見つかったデフレーションヒントを維持します。(これがデフォルトです。)
.RE .RE
.PP
.LP \-g, \-\-no\-gzip
.LP .RS 4
\f4\-mvalue \-\-modification\-time=\fP\f2value\fP \fIpack200\fRファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。
.LP .sp
.LP .if n \{\
返される値は次のどれかになります。 .RS 4
.LP .\}
.RS 3 .nf
.TP 3 pack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar
latest .fi
パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 .if n \{\
.TP 3
keep
入力 JAR. 内で見つかった変更時刻を維持します。(これがデフォルトです。)
.RE .RE
.\}
.LP
.LP
\f4\-Pfile \-\-pass\-file=\fP\f2file\fP
.LP
.LP
ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。システムファイルセパレータが JAR ファイルセパレータ「\f2/\fP」に置き換えられる点を除き、パス名の変換は行われません。 結果として得られるファイル名は、文字列として正確に JAR ファイルでの出現と一致している必要があります。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
.LP
.LP
\f4\-Uaction \-\-unknown\-attribute=\fP\f2action\fP
.LP
.LP
デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
error
\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
属性はドロップされます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。
.TP 3
pass
この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
.RE .RE
.PP
.LP \-G, \-\-strip\-debug
.LP .RS 4
\f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP 出力からデバッグ属性を削除します。これには、\fISourceFile\fR、\fILineNumberTable\fR、\fILocalVariableTable\fR、\fILocalVariableTypeTable\fRが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
.br
\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
.LP
.LP
これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
some\-layout\-string
レイアウト言語は、JSR 200 仕様に定義されています。
.LP
例: \f2\-\-class\-attribute=SourceFile=RUH\fP
.TP 3
error
この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダーの障害が発生することがあります。
.RE .RE
.PP
.LP \-\-keep\-file\-order
.LP .RS 4
例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。 入力ファイル内のファイルの順序を保持します。これは、デフォルトの動作です。
.LP .RE
.LP .PP
\f4\-f\fP\f2 \fP\f2pack.properties\fP \f3\-\-config\-file=\fP\f2pack.properties\fP \-O, \-\-no\-keep\-file\-order
.LP .RS 4
.LP パック・ツールは、すべての要素を並べ替えて送信します。パック・ツールは、JARディレクトリ名を削除してダウンロード・サイズを削減することもできます。ただし、インデックスなど、特定のJARファイルの最適化機能が正常に動作しなくなることがあります。
コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。 .RE
.LP .PP
.LP \-S\fIvalue\fR, \-\-segment\-limit=\fIvalue\fR
\f2% pack200 \-f pack.properties myarchive.pack.gz myarchive.jar\fP .RS 4
.br この値は、各アーカイブ・セグメントの予想ターゲット・サイズ\fIN\fR
\f2% more pack.properties\fP (バイト単位)です。単一の入力ファイルの必要サイズが\fIN\fRバイトを超えると、独立したセグメントが割り当てられます。特殊なケースとして、値が\fI\-1\fRの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が0の場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。
.br .sp
\f2# Generic properties for the packer.\fP 各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。
.br .sp
\f2modification.time=latest\fP デフォルトは\-1です。つまり、パック・ツールは単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化(分割)してより小さなJARにすることを強くお薦めします。
.br .sp
\f2deflate.hint=false\fP この制限が課されていない10 MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。
.br .RE
\f2keep.file.order=false\fP .PP
.br \-E\fIvalue\fR, \-\-effort=\fIvalue\fR
\f2# This option will cause the files bearing new attributes to\fP .RS 4
.br 単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル1の場合は、比較的短い圧縮時間で多少大きめのファイルが生成されますが、レベル9の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値0を指定した場合は、\fIpack200\fRコマンドは元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。
\f2# be reported as an error rather than passed uncompressed.\fP .sp
.br デフォルトは5です。この場合、標準的な時間で適切な圧縮が行われます。
\f2unknown.attribute=error\fP .RE
.br .PP
\f2# Change the segment limit to be unlimited.\fP \-H\fIvalue\fR, \-\-deflate\-hint=\fIvalue\fR
.br .RS 4
\f2segment.limit=\-1\fP 入力情報を保存するというデフォルト値をオーバーライドします。転送されるアーカイブのサイズは大きくなる場合があります。指定可能な値は、\fItrue\fR、\fIfalse\fRまたは\fIkeep\fRです。
.LP .sp
.LP \fIvalue\fRが\fItrue\fRまたはfalseの場合、\fIpacker200\fRコマンドは指定に従ってデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。
\f4\-v \-\-verbose\fP .sp
.LP \fIkeep\fR値は、入力JARで確認されたデフレーション・ヒントを保持します。これがデフォルトです。
.LP .RE
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。 .PP
.LP \-m\fIvalue\fR, \-\-modification\-time=\fIvalue\fR
.LP .RS 4
\f4\-q \-\-quiet\fP 指定可能な値は\fIlatest\fRと\fIkeep\fRです。
.LP .sp
.LP 値が最新の場合、パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
メッセージを表示せずに動作します。 .sp
.LP 値が\fIkeep\fRの場合、入力JARで確認された変更時間が保持されます。これがデフォルトです。
.LP .RE
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP .PP
.LP \-P\fIfile\fR, \-\-pass\-file=\fIfile\fR
.LP .RS 4
出力メッセージのログファイルを指定します。 ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイル・セパレータのスラッシュ(/)に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。\fIfile\fRにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
.LP .RE
.LP .PP
\f4\-? \-h \-\-help\fP \-U\fIaction\fR, \-\-unknown\-attribute=\fIaction\fR
.LP .RS 4
.LP デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラス・ファイルが、指定した\fIaction\fRによって渡されます。アクションとして指定可能な値は、\fIerror\fR、\fIstrip\fRまたは\fIpass\fRです。
.sp
値が\fIerror\fRの場合、\fIpack200\fRコマンド操作全体が失敗して適切な説明が表示されます。
.sp
値が\fIstrip\fRの場合、属性は削除されます。Java仮想マシン(JVM)必須属性を削除すると、クラス・ローダーの障害が発生することがあります。
.sp
値が\fIpass\fRの場合、クラス全体が1つのリソースとして転送されます。
.RE
.PP
\-C\fIattribute\-name\fR=\fIlayout\fR, \-\-class\-attribute=\fIattribute\-name\fR=\fIaction\fR
.RS 4
次のオプションを参照してください。
.RE
.PP
\-F\fIattribute\-name\fR=\fIlayout\fR, \-\-field\-attribute=\fIattribute\-name\fR=\fIaction\fR
.RS 4
次のオプションを参照してください。
.RE
.PP
\-M\fIattribute\-name\fR=\fIlayout\fR, \-\-method\-attribute=\fIattribute\-name\fR=\fIaction\fR
.RS 4
次のオプションを参照してください。
.RE
.PP
\-D\fIattribute\-name\fR=\fIlayout\fR, \-\-code\-attribute=\fIattribute\-name\fR=\fIaction\fR
.RS 4
前述の4つのオプションでは、クラス・エンティティに\fIclass\-attribute\fR、\fIfield\-attribute\fR、\fImethod\-attribute\fRおよび\fIcode\-attribute\fRなどの属性のレイアウトを指定できます。\fIattribute\-name\fRには、これからレイアウトまたはアクションを定義する属性の名前を指定します。\fIaction\fRとして指定可能な値は、\fIsome\-layout\-string\fR、\fIerror\fR、\fIstrip\fR、\fIpass\fRです。
.sp
\fIsome\-layout\-string\fR: レイアウト言語はJSR 200仕様で定義されています。例:
\fI\-\-class\-attribute=SourceFile=RUH\fR。
.sp
値が\fIerror\fRの場合、\fIpack200\fR操作が失敗して説明が表示されます。
.sp
値が\fIstrip\fRの場合、属性が出力から削除されます。VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。たとえば、\fI\-\-class\-attribute=CompilationID=pass\fRというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。
.sp
値が\fIpass\fRの場合、クラス全体が1つのリソースとして転送されます。
.RE
.PP
\-f \fIpack\&.properties\fR, \-\-config\-file=\fIpack\&.properties\fR
.RS 4
コマンドラインに、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。
.sp
.if n \{\
.RS 4
.\}
.nf
pack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar
more pack\&.properties
# Generic properties for the packer\&.
modification\&.time=latest
deflate\&.hint=false
keep\&.file\&.order=false
# This option will cause the files bearing new attributes to
# be reported as an error rather than passed uncompressed\&.
unknown\&.attribute=error
# Change the segment limit to be unlimited\&.
segment\&.limit=\-1
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-v, \-\-verbose
.RS 4
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが作成されます。
.RE
.PP
\-q, \-\-quiet
.RS 4
メッセージを表示せずに動作するように指定します。
.RE
.PP
\-l\fIfilename\fR, \-\-log\-file=\fIfilename\fR
.RS 4
出力メッセージのログ・ファイルを指定します。
.RE
.PP
\-?, \-h, \-\-help
.RS 4
このコマンドに関するヘルプ情報を出力します。 このコマンドに関するヘルプ情報を出力します。
.LP
.LP
\f4\-V \-\-version\fP
.LP
.LP
このコマンドに関するバージョン情報を出力します。
.LP
.LP
\f4\-J\fP\f2option\fP
.LP
.LP
\f2option\fP を、 \f2pack200\fP から呼び出された Java 起動ツールに渡します。たとえば、 \f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーが 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、 \f2pack200\fP の標準オプションではありません。 \f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.LP
.SH "終了ステータス"
.LP
.LP
次の終了値が返されます。
.LP
.LP
\f2\ 0\fP 正常終了した場合
.LP
.LP
\f2>0\fP エラーが発生した場合
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
unpack200(1)
.TP 2
o
.na
\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
o
.na
\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
jar(1) \- Java Archive ツール」
.TP 2
o
jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
\f2attributes(5) の\fP マニュアルページ
.RE .RE
.PP
.LP \-V, \-\-version
.SH "注意事項" .RS 4
.LP このコマンドに関するバージョン情報を出力します。
.LP .RE
このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。 .PP
.LP \-J\fIoption\fR
.LP .RS 4
SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 指定されたオプションをJava仮想マシンに渡します。詳細は、java(1)コマンドのリファレンス・ページを参照してください。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。
.LP .RE
.SH "終了ステータス"
.PP
次の終了値が返されます: 正常終了の場合は0、エラーが発生した場合は0より大きい値。
.SH "注意"
.PP
このコマンドと\fIpack\fR(1)を混同しないでください。\fIpack\fRおよび\fIpack200\fRコマンドは、別々の製品です。
.PP
JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
unpack200(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jar(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jarsigner(1)
.RE
.br
'pl 8.5i
'bp

270
jdk/src/linux/doc/man/ja/policytool.1
View File

@ -1,105 +1,173 @@
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: policytool
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: セキュリティ・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH policytool 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
policytool \- PolicyTool 管理 GUI ユーティリティー .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
\f3policytool\fP は、ユーティリティー GUI 経由で取得したユーザー入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。 .\" questions.
.RS 3 .\"
.TP 2 .pl 99999
o .TH "policytool" "1" "2013年11月21日" "JDK 8" "セキュリティ・ツール"
形式 .\" -----------------------------------------------------------------
.TP 2 .\" * Define some portability stuff
o .\" -----------------------------------------------------------------
説明 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.TP 2 .\" http://bugs.debian.org/507673
o .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
オプション .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.TP 2 .ie \n(.g .ds Aq \(aq
o .el .ds Aq '
関連項目 .\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
policytool \- ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIpolicytool\fR [ \fI\-file\fR ] [ \fIfilename\fR ]
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
.SH "形式" \-file
.LP .RS 4
.RS 3 ポリシー・ファイルを読み込むように\fIpolicytool\fRに指示します。
.TP 3
\
.TP 3
policytool 管理者ユーティリティーを実行します
\f4policytool\fP
.TP 3
policytool を実行し、指定されたポリシーファイルを読み込みます
\f4policytool\fP\f2[\-file\ \fP\f2filename\fP\f2]\fP
.TP 3
\
.TP 3
以下にそれぞれの意味を示します。
.RS 3
.TP 3
file
ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
.TP 3
filename
ファイル名
.RE .RE
.SH "説明" .PP
.LP \fIfilename\fR
\f3policytool\fP は、ユーザーがローカルポリシーファイルの内容を管理することを可能にする GUI です。詳細については、 .RS 4
.na ロードするファイルの名前。
\f2「ポリシーファイル作成および管理ツール」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。
.SH "オプション"
.RS 3
.TP 3
file
\f2filename\fP を読み込みます。
.SH "関連項目"
.na
\f2「Default Policy Implementation and Syntax」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
.br
.na
\f2「Policy Tool Users' Guide」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html
.br
.na
\f2「Security Permissions」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
.br
.na
\f2「Security Overview」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
.br
.RE .RE
.PP
\fB例\fR:
.PP
ポリシー・ツール管理ユーティリティを実行します:
.sp
.if n \{\
.RS 4
.\}
.nf
policytool
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
\fIpolicytool\fRコマンドを実行し、指定されたファイルをロードします:
.sp
.if n \{\
.RS 4
.\}
.nf
policytool\-file mypolicyfile
.fi
.if n \{\
.RE
.\}
.SH "説明"
.PP
\fIpolicytool\fRコマンドは、管理者のGUIを呼び出します。これにより、システム管理者はローカル・ポリシー・ファイルの内容を管理できるようになります。ポリシー・ファイルは\fI\&.policy\fR拡張子を持つプレーンテキスト・ファイルで、ドメイン別にリモート・リクエスタを権限オブジェクトにマップします。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある
「Default Policy Implementation and Policy File Syntax」を参照してください
.SH "オプション"
.PP
\-file
.RS 4
ポリシー・ファイルを読み込むように\fIpolicytool\fRに指示します。
.RE
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Default Policy Implementation and Policy File Syntax」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Policy File Creation and Management」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyGuide\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Permissions in Java SE Development Kit (JDK)」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/permissions\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Java Security Overview」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/overview/jsoverview\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Java Cryptography Architecture (JCA) Reference Guide」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html)
.RE
.br
'pl 8.5i
'bp

561
jdk/src/linux/doc/man/ja/rmic.1
View File

@ -1,231 +1,360 @@
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: rmic
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Remote Method Invocation (RMI)ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH rmic 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
rmic \- Java RMI コンパイラ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。 .\"
.LP .pl 99999
.SH "形式" .TH "rmic" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
rmic \- Java Remote Method Protocol (JRMP)またはInternet Inter\-Orb protocol (IIOP)を使用するリモート・オブジェクトのスタブ、スケルトンおよびTieクラスを生成します。Object Management Group (OMG)インタフェース定義言語(IDL)も生成します
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIrmic\fR [ \fIoptions\fR ] \fIpackage\-qualified\-class\-names\fR
.fl
rmic [ \fP\f3options\fP\f3 ] \fP\f4package\-qualified\-class\-name(s)\fP\f3
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・\fIオプション\fR。オプションを参照してください。
.RE
.PP
\fIpackage\-qualified\-class\-names\fR
.RS 4
パッケージを含むクラス名。例:
\fIjava\&.awt\&.Color\fR。
.RE
.SH "説明" .SH "説明"
.LP .PP
.LP \fB非推奨に関する注意:\fR
\f3rmic\fP コンパイラによって、リモートオブジェクトの、スタブ、スケルトンクラスファイル (JRMP プロトコル)、およびスタブと Tie クラスファイルの組み合わせ (IIOP プロトコル) が生成されます。リモートオブジェクトの実装クラスであるこれらのクラスファイルは、Java プログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\f2java.rmi.Remote\fP インタフェースを実装するクラスです。\f3rmic\fP コマンドでのクラス名は、そのクラスが \f3javac\fP コマンドでコンパイルが成功していて、かつ完全なパッケージ名が指定されている必要があります。たとえば、クラスファイル名 \f2HelloImpl\fP で \f3rmic\fP を実行するには、次のようにします。 Java Remote Method Protocol (JRMP)スタブおよびスケルトンの静的な生成のサポートは非推奨になりました。動的に生成されるJRMPスタブをかわりに使用して、JRMPベースのアプリケーションにこのツールを使用する必要性をなくすことをお薦めします。詳細は、\fIjava\&.rmi\&.server\&.UnicastRemoteObject\fR仕様(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/server/UnicastRemoteObject\&.html)を参照してください。
.LP .PP
\fIrmic\fRコンパイラは、Java Remote Method Protocol (JRMP)とスタブおよびTieクラス・ファイル(IIOPプロトコル)を使用して、リモート・オブジェクトのスタブおよびスケルトン・クラス・ファイルを生成します。リモート・オブジェクトの実装クラスであるこれらのクラス・ファイルは、Javaプログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\fIjava\&.rmi\&.Remote\fRインタフェースを実装するクラスです。\fIrmic\fRコマンドでのクラス名は、そのクラスが\fIjavac\fRコマンドでコンパイルが成功していて、かつ完全修飾パッケージ名である必要があります。たとえば、次に示すクラス・ファイル名\fIHelloImpl\fRで\fIrmic\fRコマンドを実行すると、helloサブディレクトリ(クラスのパッケージの名前の付いた)に\fIHelloImpl_Stub\&.class \fRファイルが作成されます。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 rmic hello\&.HelloImpl
.fl
rmic hello.HelloImpl
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。 .PP
.LP リモート・オブジェクトのスケルトンはJRMPプロトコル・サーバー側のエンティティで、リモート・オブジェクト実装を呼び出すメソッドを含みます。
.LP .PP
リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。 リモート・オブジェクトのTieは、スケルトンと同様にサーバー側のエンティティですが、IIOPプロトコルを使用してクライアントと通信します。
.LP .PP
.LP スタブとは、リモート・オブジェクトのクライアント側での代理です。スタブは、リモート・オブジェクトのメソッド呼出しを、実物のリモート・オブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモート・オブジェクトへの参照は、実際はローカル・スタブへの参照となります。
リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。 .PP
.LP デフォルトで\fIrmic\fRコマンドは、1\&.2 JRMPスタブ・プロトコル・バージョンのみを使用するスタブ・クラスを生成します。これは、\fI\-v1\&.2\fRオプションを指定した場合と同じ動作です。リリース5\&.0以前では\fI\-vcompat\fRオプションがデフォルトでした。IIOPプロトコル用のスタブおよびTieクラスを生成するには\fI\-iiop\fRオプションを使用します。オプションを参照してください。
.LP .PP
「スタブ」とは、リモートオブジェクトのクライアント側での代理です。スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。 スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクトが実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\fIPortableRemoteObject\&.narrow\fRメソッドを使用する必要があります。
.LP
.LP
デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。
.LP
.LP
スタブはリモートインタフェースだけを実装し、リモートオブジェクトが実装する局所インタフェースは実装していません。JRMP スタブはリモートオブジェクト自体が実装するリモートインタフェースと同じものを実装しているので、クライアントは、キャストや型チェックに Java プログラミング言語に組み込まれた演算子を使用することができます。IIOP の場合は、\f2PortableRemoteObject.narrow\fP メソッドを使わなければなりません。
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-bootclasspath \fIpath\fR
.TP 3 .RS 4
\-bootclasspath path ブートストラップ・クラス・ファイルの位置をオーバーライドします。
ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-classpath path
\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
.:<your_path>
.fl
\fP
.fi
例を示します。
.nf
\f3
.fl
.:/usr/local/java/classes
.fl
\fP
.fi
.TP 3
\-d directory
生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。
.nf
\f3
.fl
% rmic \-d /java/classes foo.MyClass
.fl
\fP
.fi
MyClass から取得した \f2スタブとスケルトンクラスを\fP \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた。)
.br
\
.TP 3
\-extdirs path
インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-g
局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。
.TP 3
\-idl
\f2rmic\fP によって、指定したクラスおよび参照されたクラスの OMG IDL が生成されます。IDL では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの API を指定することができます。IDL は、メソッドおよびデータの仕様として使用します。CORBA バインディングを提供する任意の言語で、メソッドおよびデータの作成および呼び出しを行うことができます。これらの言語には、Java および C++ が含まれています。詳細は、
.na
\f2Java Language to IDL Mapping\fP @
.fi
http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。
.LP
\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
\-always または \-alwaysgenerate
既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-factory
生成された IDL で factory キーワードを使います。
.TP 3
\-idlModule\ fromJavaPackage[.class]\ toIDLModule
IDLEntity パッケージのマップを指定します。例を示します。 \f2\-idlModule foo.bar my::real::idlmod\fP
.TP 3
\-idlFile\ fromJavaPackage[.class]\ toIDLFile
IDLEntity ファイルのマップを指定します。例を示します。 \f2\-idlFile test.pkg.X TEST16.idl\fP\
.RE .RE
.TP 3 .PP
\-iiop \-classpath path
\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。 .RS 4
.LP \fIrmic\fRコマンドがクラスを探すためのパスを指定します。このオプションは、デフォルトや\fICLASSPATH\fR環境変数設定をオーバーライドします。ディレクトリはコロンで分割します。パスの一般的な形式は\fI\&.;<your_path>\fRです。例:
\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。 \fI\&.;/usr/local/java/classes\fR
.RE
.PP
\-d \fIdirectory\fR
.RS 4
生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使用すると、スタブ、スケルトン、およびTieファイルを格納するディレクトリを指定できます。たとえば、次のコマンドはMyClassから導出されたスタブおよびスケルトン・クラスをディレクトリ/java/classes/exampleclassに格納します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 rmic \-d /java/classes exampleclass\&.MyClass
.fl
_<implementationName>_stub.class
.fl
\fP
.br
\f3
.fl
_<interfaceName>_tie.class
.fl
\fP
.fi .fi
.LP .if n \{\
\f2\-iiop\fP オプションを使うときは、ほかのオプションも指定できます。 .RE
.RS 3 .\}
.TP 3 \fI\-d\fRオプションが指定されていない場合、デフォルトの動作は\fI\-d\fRが指定されていた場合と同じです。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、stub/tie/skeletonファイルが格納されます。以前のリリースの\fIrmic\fRコマンドでは、\fI\-d\fRが指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていました。
\-always または \-alwaysgenerate .RE
既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。 .PP
.TP 3 \-extdirs \fIpath\fR
\-nolocalstubs .RS 4
同じプロセスのクライアントとサーバーに対して最適化されたスタブを作成しません。 インストール済拡張機能の位置をオーバーライドします。
.TP 3 .RE
\-noValueMethods .PP
これは \f2\-idl\fP オプションとともに使われなければなりません。発行された IDL に、\f2valuetype\fP メソッドおよび初期化子を追加しません。このメソッドおよび初期化子は、\f2valuetype\fP の場合はオプションです。 \f2\-idl\fP オプションを使うときは、 \f2\-noValueMethods\fP オプションを指定しない限り生成されます。 \-g
.TP 3 .RS 4
\-poa ローカル変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報のみ生成されます。
継承が \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP から \f2org.omg.PortableServer.Servant\fP に変わります。 .RE
.LP .PP
.na \-idl
\f2Portable Object Adapter\fP @ .RS 4
\fIrmic\fRコマンドによって、指定したクラスおよび参照されたクラスのOMG IDLが生成されます。IDLでは、プログラミング言語に依存せずに、宣言するだけでオブジェクトのAPIを指定することができます。IDLは、メソッドおよびデータの仕様として使用します。CORBAバインディングを提供する任意の言語で、メソッドおよびデータの作成および呼出しを行うことができます。これらの言語には、JavaおよびC++が含まれています。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlの
「Java IDL: IDL to Java Language Mapping」を参照してください
.sp
\fI\-idl\fRオプションを使用するときには、他のオプションも指定できます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fI\-always\fRまたは\fI\-alwaysgenerate\fRオプションは再生成を強制します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-factory\fRオプションは、生成されたIDLで\fIfactory\fRキーワードを使用します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
\fI\-idlModule\fR
from J\fIavaPackage[\&.class]\fR
\fItoIDLModule\fR
specifies
\fIIDLEntity\fR
package mapping, for example:
\fI\-idlModule\fR
\fImy\&.module my::real::idlmod\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-idlFile\fR
\fIfromJavaPackage[\&.class] toIDLFile\fR
specifies
\fIIDLEntity\fR
file mapping, for example:
\fI\-idlFile test\&.pkg\&.X TEST16\&.idl\fR\&.
.RE
.RE
.PP
\-iiop
.RS 4
\fIrmic\fRコマンドによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、スタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。
.sp
\fI\-iiop\fRを使用して\fIrmic\fRコマンドを呼び出すと、次の命名規則に準拠したスタブとTieが生成されます。
.sp
.if n \{\
.RS 4
.\}
.nf
_<implementationName>_stub\&.class
_<interfaceName>_tie\&.class
.fi .fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は Java の \f2org.omg.PortableServer.Servant\fP クラスにマップされます。このクラスは、すべての POA サーバント実装の基底クラスとして機能し、アプリケーションプログラマが呼び出すことのできるいくつかのメソッドのほかに、POA そのものによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドも提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。 .if n \{\
.RE .RE
.TP 3 .\}
\-J .sp
\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。 .RS 4
.TP 3 .ie n \{\
\-keep または \-keepgenerated \h'-04'\(bu\h'+03'\c
スタブ、スケルトン、または Tie クラスのための \f2.java\fP ソースファイルを \f2.class\fP ファイルと同じディレクトリに残します。 .\}
.TP 3 .el \{\
\-nowarn .sp -1
警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。 .IP \(bu 2.3
.TP 3 .\}
\-nowrite \fI\-iiop\fRオプションを使用するときには、他のオプションも指定できます。
コンパイルしたクラスをファイルシステムに書き込みません。 .RE
.TP 3 .sp
\-vcompat .RS 4
1.1 と 1.2 の両方の JRMP スタブプロトコルバージョンと互換性のあるスタブおよびスケルトンクラスを作成します。(5.0 以前のリリースではこのオプションはデフォルト。)生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされると 1.1 スタブプロトコルバージョンを使用し、JDK 1.2 以降の仮想マシンにロードされると 1.2 スタブプロトコルバージョンを使用します。生成されたスケルトンクラスでは、1.1 と 1.2 の両方のスタブプロトコルバージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。 .ie n \{\
.TP 3 \h'-04'\(bu\h'+03'\c
\-verbose .\}
コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。 .el \{\
.TP 3 .sp -1
\-v1.1 .IP \(bu 2.3
1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。 .\}
.TP 3 既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fI\-always\fRまたは\fI\-alwaysgenerate\fRオプションは再生成を強制します。
\-v1.2 .RE
(デフォルト) 1.2 JRMP スタブプロトコルバージョンのみのスタブクラスを生成します。スケルトンクラスは 1.2 スタブプロトコルバージョンで使用できないため、このオプションではスケルトンクラスは生成されません。生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされても動作しません。 .sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-nolocalstubs\fRオプションでは、同じプロセスのクライアントとサーバーに最適化されたスタブは作成されません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-noValueMethods\fRオプションは\fI\-idl\fRオプションとともに使用する必要があります。\fI\-noValueMethods\fRオプションは、送信されるIDLに\fIvaluetype\fRメソッドおよび初期化子を追加できないようにします。このメソッドおよび初期化子は、valuetypeの場合はオプションです。\fI\-idl\fRオプションとともに\fI\-noValueMethods\fRオプションを指定しないかぎり生成されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-poa\fRオプションは継承を\fIorg\&.omg\&.CORBA_2_3\&.portable\&.ObjectImpl\fRから\fIorg\&.omg\&.PortableServer\&.Servant\fRに変更します。ポータブル・オブジェクト・アダプタ(POA)の\fIPortableServer\fRモジュールは、ネイティブの\fIServant\fR型を定義します。Javaプログラミング言語では、\fIServant\fR型はJavaの\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2\&.3\&.1 ptc/00\-01\-08\&.pdfに準拠しています。
.RE
.RE
.PP
\-J
.RS 4
Javaコマンドとともに使用して、\fI\-J\fRオプションは\fI\-J\fRの後ろに続く引数をJavaインタプリタに渡します(\fI\-J\fRと引数の間にスペースは入れません)。
.RE
.PP
\-keep or \-keepgenerated
.RS 4
スタブ、スケルトン、またはTieクラスのために生成された\fI\&.java\fRソース・ファイルを保持し、\fI\&.class\fRファイルと同じディレクトリに書き込みます。
.RE
.PP
\-nowarn
.RS 4
警告をオフにします。\fI\-nowarn\fRオプションが使用される場合。コンパイラは警告を表示しません。
.RE
.PP
\-nowrite
.RS 4
コンパイルしたクラスをファイル・システムに書き込みません。
.RE
.PP
\-vcompat (非推奨)
.RS 4
1\&.1と1\&.2の両方のJRMPスタブ・プロトコル・バージョンと互換性のあるスタブおよびスケルトン・クラスを作成します。5\&.0以前のリリースではこのオプションがデフォルトでした。生成されたスタブ・クラスは、JDK 1\&.1仮想マシンにロードされると1\&.1スタブ・プロトコル・バージョンを使用し、JDK 1\&.2以降の仮想マシンにロードされると1\&.2スタブ・プロトコル・バージョンを使用します。生成されたスケルトン・クラスでは、1\&.1と1\&.2の両方のスタブ・プロトコル・バージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。注意:このオプションは非推奨になりました。説明を参照してください。
.RE
.PP
\-verbose
.RS 4
コンパイラやリンカーが、コンパイルされているクラスやロードされているクラス・ファイルについてのメッセージを表示するようにします。
.RE
.PP
\-v1\&.1 (非推奨)
.RS 4
1\&.1 JRMPスタブ・プロトコル・バージョンのみのスタブおよびスケルトン・クラスを生成します。\fI\-v1\&.1\fRオプションを使用できるのは、JDK 1\&.1から\fIrmic\fRコマンドで生成され、アップグレードできない(さらにダイナミック・クラス・ローディングを使用していない)、既存の静的デプロイされたスタブ・クラスに対し、直列化互換性のあるスタブ・クラスを生成する場合のみです。注意:このオプションは非推奨になりました。説明を参照してください。
.RE
.PP
\-v1\&.2 (非推奨)
.RS 4
(デフォルト)1\&.2 JRMPスタブ・プロトコル・バージョンのみのスタブ・クラスを生成します。スケルトン・クラスは1\&.2スタブ・プロトコル・バージョンで使用できないため、スケルトン・クラスは生成されません。生成されたスタブ・クラスは、JDK 1\&.1仮想マシンにロードされても動作しません。注意:このオプションは非推奨になりました。説明を参照してください。
.RE .RE
.LP
.SH "環境変数" .SH "環境変数"
.LP .PP
.RS 3 CLASSPATH
.TP 3 .RS 4
CLASSPATH ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例:
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。 \fI\&.:/usr/local/java/classes\fR
.nf
\f3
.fl
.:/usr/local/java/classes
.fl
\fP
.fi
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
.LP .RS 4
java(1)、javac(1)、 .ie n \{\
.na \h'-04'\(bu\h'+03'\c
\f2CLASSPATH\fP @ .\}
.fi .el \{\
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath .sp -1
.LP .IP \(bu 2.3
.\}
javac(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Setting the Class Path
.RE
.br
'pl 8.5i
'bp

655
jdk/src/linux/doc/man/ja/rmid.1
View File

@ -1,328 +1,365 @@
." Copyright (c) 1998, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: rmid
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Remote Method Invocation (RMI)ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH rmid 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
rmid \- Java RMI 起動システムデーモン .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。 .\"
.LP .pl 99999
.SH "形式" .TH "rmid" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
rmid \- 起動システム・デーモンを開始すると、オブジェクトをJava仮想マシン(VM)に登録してアクティブ化できるようになります。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIrmid\fR [\fIoptions\fR]
.fl
rmid [options]
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.SH "説明" .SH "説明"
.LP .PP
.LP \fIrmid\fRコマンドは、起動システム・デーモンを開始します。起動システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、JVM内でアクティブ化したりすることができません。アクティブ化可能なオブジェクトを使用するプログラムの作成方法の詳細は、\fIアクティブ化の使用\fRに関するチュートリアル(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html)を参照してください
\f3rmid\fP ツールは、起動システムデーモンを開始します。起動システムデーモンを開始してからでないと、起動可能オブジェクトを起動システムに登録したり、VM 内で起動したりすることができません。起動可能なリモートオブジェクトを使ったプログラムの作成方法の詳細は、 .PP
.na \fIrmid\fRコマンドを実行し、次のようにセキュリティ・ポリシー・ファイルを指定して、デーモンを起動します。
\f2「Java RMI 仕様」\fP @ .sp
.fi .if n \{\
http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.htmlおよび .RS 4
.na .\}
\f2「起動のチュートリアル」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlを参照してください。
.LP
.LP
デーモンを起動するには、次のように、セキュリティーポリシーファイルを指定して \f2rmid\fP コマンドを実行します。
.LP
.nf .nf
\f3 rmid \-J\-Djava\&.security\&.policy=rmid\&.policy
.fl
rmid \-J\-Djava.security.policy=rmid.policy
.fl
\fP
.fi .fi
.if n \{\
.LP
.LP
\f3注:\fP \f2rmid\fP の Sun の 実装を実行する場合、デフォルトでは、セキュリティーポリシーファイルを指定する必要があります。それは、 \f2rmid\fP が起動グループ用に VM を起動するために各 \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを検証できるようにするためです。特に、ActivationGroupDesc のコンストラクタに渡される \f2CommandEnvironment\fP や任意の \f2Properties\fP によって指定される \f2コマンドおよび\fPオプションは、 \f2rmid\fP のセキュリティーポリシーファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fP プロパティーの値は、 \f2起動グループ用に VM を\fP 起動するために \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを判断するときに rmid が使用するポリシーを決定します。
.LP
.LP
\f2rmid\fP をデフォルト設定で実行すると、次のような処理が行われます。
.LP
.RS 3
.TP 2
o
アクティベータを起動し、デフォルトポート 1098 で内部レジストリを起動する
.TP 2
o
この内部レジストリの中で、 \f2ActivationSystem\fP を \f2java.rmi.activation.ActivationSystem という名前に\fP バインドする
.RE .RE
.\}
.LP .PP
.LP \fIrmid\fRコマンドのOracleの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\fIrmid\fRコマンドが起動グループ用にJVMを起動するために各\fIActivationGroupDesc\fR内の情報を使用できるかどうかを検証できるようにするためです特に、\fIActivationGroupDesc\fRコンストラクタに渡される\fICommandEnvironment\fRや任意のプロパティによって指定されるコマンドおよびオプションは、\fIrmid\fRコマンドのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\fIsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値は、起動グループ用にJVMを起動するために\fIActivationGroupDesc\fR内の情報を使用できるかどうかを判断するときに\fIrmid\fRコマンドが使用するポリシーを決定します。詳細は、\-J\-Dsun\&.rmi\&.activation\&.execPolicy=policyオプションの説明を参照してください。
レジストリにほかのポートを指定するには、rmid の起動時に \f2\-port\fP オプションを \f2指定しなければなりません\fP。次に例を示します。 .PP
.LP \fIrmid\fRコマンドを実行すると、デフォルト・ポート1098でアクティベータと内部レジストリが起動され、\fIActivationSystem\fRがこの内部レジストリ内の名前\fIjava\&.rmi\&.activation\&.ActivationSystem\fRにバインドされます。
.PP
レジストリに他のポートを指定するには、\fIrmid\fRコマンドの実行時に\fI\-port\fRオプションを指定する必要があります。たとえば、次のコマンドは、レジストリのデフォルト・ポート1099で、起動システム・デーモンとレジストリを起動します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 rmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099
.fl
rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
.fl
\fP
.fi .fi
.if n \{\
.LP
.LP
このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート 1099 でレジストリを開始します。
.LP
.SS
rmid を inetd/xinetd から開始する
.LP
.LP
\f2rmid\fP をコマンド行から開始するには、 \f2inetd\fP (Solaris の場合)、または \f2xinetd\fP (Linux の場合) を構成して \f2rmid\fP を必要に応じて開始する方法もあります。
.LP
.LP
\f2rmid\fP を開始すると、System.inheritedChannel メソッドを呼び出して、継承されたチャンネル ( \f2inetd\fP/\f2xinetd\fP から継承) を取得しようとします。 継承されたチャンネルが \f2null\fP であるか、 \f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、 \f2rmid\fP rmid はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
.LP
.LP
継承されたチャンネルが \f2ServerSocketChannel\fP インスタンスである場合は、 \f2rmid\fP はエクスポートするリモートオブジェクト、つまり java.rmi.activation.ActivationSystem がバインドされているレジストリと java.rmi.activation.Activator リモートオブジェクトに対する要求を受信するサーバーソケットとして、ServerSocketChannel から取得した java.net.ServerSocket を使用します。 このモードでは、 \f2rmid\fP の動作は、次のことを除いて、 コマンド行から起動した場合と同じです。
.LP
.RS 3
.TP 2
o
\f2System.err\fP に対する出力は、ファイルにリダイレクトされる。このファイルは \f2java.io.tmpdir\fP システムプロパティーで指定されるディレクトリ (通常は \f2/var/tmp\fP または \f2/tmp\fP) にある。ファイル名の接頭辞は \f2"rmid\-err"\fP で、接尾辞は \f2"tmp"\fP である
.TP 2
o
\f2\-port\fP オプションは拒否される。このオプションを指定すると、 \f2rmid\fP はエラーメッセージを出して終了する
.TP 2
o
\f2\-log\fP オプションは必須。このオプションを指定しないと、 \f2rmid\fP はエラーメッセージを出して終了する
.RE .RE
.\}
.LP .SH "必要に応じてRMIDを開始"
.LP .PP
必要に応じてサービスを開始するように設定する詳細については、 \f2inetd\fP (Solaris の場合)、または \f2xinetd\fP (Linux) のマニュアルページを参照してください。 \fIrmid\fRをコマンドラインから開始するには、\fIinetd\fR
.LP (Oracle Solarisの場合)、または\fIxinetd\fR
(Linuxの場合)を構成して\fIrmid\fRを必要に応じて開始する方法もあります。
.PP
RMIDを開始すると、\fISystem\&.inheritedChannel\fRメソッドを呼び出して、継承されたチャンネル(\fIinetd\fR/\fIxinetd\fRから継承)を取得しようとします。継承されたチャンネルがnullであるか、\fIjava\&.nio\&.channels\&.ServerSocketChannel\fRのインスタンスでなかった場合、RMIDはそのチャンネルは\fIinetd\fR/\fIxinetd\fRによって起動されたものではないと判断し、前述のように起動します。
.PP
継承されたチャンネルが\fIServerSocketChannel\fRインスタンスである場合は、RMIDはエクスポートするリモート・オブジェクト、つまり\fIjava\&.rmi\&.activation\&.ActivationSystem\fRがバインドされているレジストリと\fIjava\&.rmi\&.activation\&.Activator\fRリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\fIServerSocketChannel\fRから取得した\fIjava\&.net\&.ServerSocket\fRを使用します。このモードでは、RMIDの動作は、次のことを除いて、コマンドラインから起動した場合と同じです。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fISystem\&.err\fRに対する出力は、ファイルにリダイレクトされる。このファイルは\fIjava\&.io\&.tmpdir\fRシステム・プロパティで指定されるディレクトリ(通常は\fI/var/tmp\fRまたは\fI/tmp\fR)にある。ファイル名の接頭辞は\fIrmid\-err\fRで、接尾辞は\fItmp\fRである。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-port\fRオプションは使用できません。このオプションが指定されている場合、RMIDはエラー・メッセージが表示されて終了します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-log\fRオプションは必須。このオプションが指定されていない場合、RMIDはエラー・メッセージが表示されて終了します。
.RE
.PP
必要に応じてサービスを開始するように構成する方法の詳細は、\fIinetd\fR
(Oracle Solarisの場合)、または\fIxinetd\fR
(Linux)のマニュアル・ページを参照してください。
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-C\fIオプション\fR
.TP 3 .RS 4
\-C<someCommandLineOption> \fIrmid\fRコマンドの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンドライン引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。
\f2rmid\fP の子プロセス (起動グループ) が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモンによって生成される各仮想マシンにプロパティーを渡すことができます。 .sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 rmid \-C\-Dsome\&.property=value
.fl
rmid \-C\-Dsome.property=value
.fl
\fP
.fi .fi
コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。 .if n \{\
.RE
.\}
コマンドライン引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のコマンドでは、すべての子JVMでserver\-callロギングが可能です。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 rmid \-C\-Djava\&.rmi\&.server\&.logCalls=true
.fl
rmid \-C\-Djava.rmi.server.logCalls=true
.fl
\fP
.fi .fi
このコマンドにより、すべての子 VM でサーバー呼び出しのログが作成されるようになります。 .if n \{\
.LP .RE
.TP 3 .\}
\-J<someCommandLineOption> .RE
rmid を実行している \f2java\fP インタプリタに渡すオプションを指定します。 たとえば、 \f2rmid\fP が \f2rmid.policy\fP という名前のポリシーファイルを使用するように指定するには、rmid のコマンド行で \f2\-J\fP オプションを使って、 \f2java.security.policy\fP プロパティーを定義します。 次に例を示します。 .PP
\-J\fIoption\fR
.RS 4
RMIDを実行しているJavaインタプリタに渡すオプションを指定します。たとえば、\fIrmid\fRコマンドが\fIrmid\&.policy\fRという名前のポリシー・ファイルを使用するように指定するには、\fIrmid\fRのコマンドラインで\fI\-J\fRオプションを使用して、\fIjava\&.security\&.policy\fRプロパティを定義します。次に例を示します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 rmid \-J\-Djava\&.security\&.policy\-rmid\&.policy
.fl
rmid \-J\-Djava.security.policy=rmid.policy
.fl
\fP
.fi .fi
.TP 3 .if n \{\
\-J\-Dsun.rmi.activation.execPolicy=<policy> .RE
起動グループが実行されることになる VM の起動に使用するコマンドおよびコマンド行オプションをチェックするために、 \f2rmid\fP が採用するポリシーを指定します。このオプションは、Java RMI 起動デーモンの Sun の実装だけに存在することに注意してください。コマンド行にこのプロパティーを指定しない場合、結果は \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP を指定した場合と同じになります。\f2<policy>\fP に指定可能な値は、\f2default\fP、\f2<policyClassName>\fP、または \f2none\fP です。 .\}
.RS 3 .RE
.TP 2 .PP
o \-J\-Dsun\&.rmi\&.activation\&.execPolicy=\fIpolicy\fR
\f3default (または、このプロパティーが「指定されていない」場合)\fP .RS 4
.LP 起動グループが実行されることになるJVMの起動に使用するコマンドおよびコマンドライン・オプションをチェックするために、RMIDが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのOracleの実装のみに存在することに注意してください。コマンドラインにこのプロパティを指定しない場合、結果は\fI\-J\-Dsun\&.rmi\&.activation\&.execPolicy=default\fRを指定した場合と同じになります。\fIpolicy\fRに指定可能な値は、\fIdefault\fR、\fIpolicyClassName\fRまたは\fInone\fRです。
デフォルトの \f2execPolicy\fP の場合、 \f2rmid\fP が実行できるのは、 \f2rmid\fP が使用するセキュリティーポリシーファイルの中で、実行する権限が \f2rmid\fP に与えられているコマンドおよびコマンド行オプションだけです。「デフォルト」の実行ポリシーで使用できるのは、デフォルトの起動グループ実装だけです。 .sp
.LP .RS 4
\f2rmid は、\fP 起動グループ用の VM を起動するときに、そのグループについて登録された起動グループ記述子である \f2ActivationGroupDesc\fP 内の情報を使用します。グループ記述子は、 \f2ActivationGroupDesc.CommandEnvironment\fP を指定します (省略可能)。これには、起動グループを開始する「コマンド」と、そのコマンド行に追加できるコマンド行「オプション」が含まれています。デフォルトでは、 \f2rmid は\fP java.home にある \f2java\fP コマンドを使用します。 グループ記述子には、オプションとしてコマンド行に追加される「プロパティー」オーバーライドも含まれています。このプロパティーは、次のように定義します。 .ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
デフォルト
.sp
\fIdefault\fRまたは未指定値の\fIexecPolicy\fRの場合、\fIrmid\fRコマンドが実行できるのは、\fIrmid\fRコマンドが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\fIrmid\fRに与えられているコマンドおよびコマンドライン・オプションのみです。デフォルトの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。
.sp
\fIrmid\fRコマンドは、起動グループ用のJVMを起動するときに、そのグループについて登録された起動グループ記述子である\fIActivationGroupDesc\fR内の情報を使用します。グループ記述子は、\fIActivationGroupDesc\&.CommandEnvironment\fRを指定します(省略可能)。これには、起動グループを開始するコマンドと、そのコマンドラインに追加できるコマンドライン・オプションが含まれています。デフォルトでは、\fIrmid\fRコマンドは\fIjava\&.home\fRにある\fIjava\fRコマンドを使用します。グループ記述子には、コマンドラインにオプションとして追加されるプロパティ・オーバーライドも含まれます(\fI\-D<property>=<value>\fRとして定義されます)。\fIcom\&.sun\&.rmi\&.rmid\&.ExecPermission\fR権限は\fIrmid\fRコマンドに、起動グループを開始するためにグループ記述子の\fICommandEnvironment\fRで指定されたコマンドを実行する権限を付与します。\fIcom\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR権限は起動グループの開始時に、グループ記述子でプロパティ・オーバーライドとして、または\fICommandEnvironment\fRでオプションとして指定されたコマンドライン・オプションを、\fIrmid\fRコマンドが使用することを許可します。\fIrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を付与する場合、権限\fIExecPermission\fRおよび\fIExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります。
.sp
\fBExecPermission\fR
.sp
\fIExecPermission\fRクラスは、起動グループを開始するために\fIrmid\fRコマンドが特定のコマンドを実行する権限を表します。
.sp
\fB構文\fR:
\fIExecPermission\fRの名前は、\fIrmid\fRコマンドに実行を許可するコマンドのパス名です。スラッシュ(/)およびアスタリスク(*)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。スラッシュはファイル区切り文字\fIFile\&.separatorChar\fRです。スラッシュ(/)およびマイナス符号(\-)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。パス名に特別なトークン\fI<<ALL FILES>>\fRを指定した場合は、任意のファイルを示します。
.sp
パス名にアスタリスク(*)を指定した場合は、現在のディレクトリ内のすべてのファイルを示します。パス名にマイナス符号(\-)を指定した場合は、現在のディレクトリ内のすべてのファイルおよび(再帰的に)現在のディレクトリに含まれるすべてのファイルとサブディレクトリを示します。
.sp
\fBExecOptionPermission\fR
.sp
\fIExecOptionPermission\fRクラスは、起動グループを開始するときに\fIrmid\fRコマンドで特定のコマンドライン・オプションを使用できる権限を表します。\fIExecOptionPermission\fRの名前は、コマンドライン・オプションの値です。
.sp
\fB構文\fR: オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスク(*)は、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、ドット(\&.)か等号(=)の直後にアスタリスク(*)を指定する必要があります。
.sp
例:
\fI*\fRや\fI\-Dmydir\&.*\fRや\fI\-Da\&.b\&.c=*\fRは有効ですが、\fI*mydir\fRや\fI\-Da*b\fRや\fIab*\fRは無効です。
.sp
\fBrmidのポリシー・ファイル\fR
.sp
\fIrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を許可する場合は、権限\fIExecPermission\fRおよび\fIExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります(汎用的に)。これらの権限をチェックするのは\fIrmid\fRコマンドのみなので、これらの権限を汎用的に付与しても安全です。
.sp
\fIrmid\fRコマンドに各種の実行権限を付与するポリシー・ファイルの例を、次に示します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3
.fl
\-D\fP\f4<property>\fP\f3=\fP\f4<value>\fP\f3
.fl
\fP
.fi
.LP
アクセス権 \f2com.sun.rmi.rmid.ExecPermission\fP を使用すると、 \f2rmid\fP に対して、グループ記述子の \f2CommandEnvironment\fP で指定されたコマンドを実行して起動グループを開始する権限を許可することができます。アクセス権 \f2com.sun.rmi.rmid.ExecOptionPermission\fP を使用すると、グループ記述子でプロパティーオーバーライドとして指定されたコマンド行オプション、または \f2CommandEnvironment\fP でオプションとして指定されたコマンド行オプションを、起動グループを開始するときに rmid が使用できるようになります。
.LP
\f2rmid に\fP さまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。つまり、すべてのコードソースに対して許可します。
.RS 3
.TP 3
ExecPermission
\f2ExecPermission\fP クラスは、起動グループを開始するために \f2rmid が\fP 特定の「コマンド」を実行する権限を表します。
.LP
\f3構文\fP
.br
\f2ExecPermission\fP の「名前」は、 \f2rmid\fP に実行を許可するコマンドのパス名です。「/*」 (「/」はファイル区切り文字 File.separatorChar) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。 「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。
.LP
\f3注:\fP 「*」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルを表します。また、「\-」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルと、現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
.TP 3
ExecOptionPermission
\f2ExecOptionPermission\fP クラスは、起動グループを開始するときに \f2rmid は、起動グループを開始するコマンドをまったく検証しません。\fP 特定のコマンド行「オプション」を使用できる権限を表します。 \f2ExecOptionPermission\fP の「名前」は、コマンド行オプションの値です。
.LP
\f3構文\fP
.br
オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカードマッチを表します。 アスタリスクは、オプション名そのものとして使用できます。 つまり、任意のオプションを表すことができます。 また、オプション名の末尾に使用することもできます。 ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。
.LP
例を示します。「*」、「\-Dfoo.*」、「\-Da.b.c=*」は有効ですが、「*foo」、「\-Da*b」、「ab*」は無効です。
.TP 3
rmid のポリシーファイル
\f2rmid に\fP さまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。つまり、すべてのコードソースに対して許可します。これらのアクセス権をチェックするのは \f2rmid\fP だけなので、これらのアクセス権を汎用的に許可しても安全です。
.LP
rmid に各種の実行権限を許可するポリシーファイルの例を、次に示します。
.nf
\f3
.fl
grant { grant {
.fl permission com\&.sun\&.rmi\&.rmid\&.ExecPermission
permission com.sun.rmi.rmid.ExecPermission "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java";
.fl
"/files/apps/java/jdk1.7.0/solaris/bin/java";
.fl
.fl
permission com.sun.rmi.rmid.ExecPermission
.fl
"/files/apps/rmidcmds/*";
.fl
.fl
permission com.sun.rmi.rmid.ExecOptionPermission
.fl
"\-Djava.security.policy=/files/policies/group.policy";
.fl
.fl
permission com.sun.rmi.rmid.ExecOptionPermission
.fl
"\-Djava.security.debug=*";
.fl
.fl
permission com.sun.rmi.rmid.ExecOptionPermission
.fl
"\-Dsun.rmi.*";
.fl
};
.fl
\fP
.fi
最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンドを使用します。 \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。
.LP
3 番目に付与されているアクセス権 \f2ExecOptionPermission\fP は、 \f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。次のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。
.LP
ポリシーファイルを指定して \f2rmid\fP を起動するには、rmid のコマンド行で \f2java.security.policy\fP プロパティーを指定する必要があります。 次に例を示します。
.LP
\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
.RE
.TP 2
o
\f4<policyClassName>\fP
.LP
デフォルトの動作では十分な柔軟性が得られない場合、管理者は、 \f2rmid\fP の起動時に、 \f2checkExecCommand\fP メソッドが所属するクラスの名前を指定して、rmid が実行するコマンドをチェックすることができます。
.LP
\f2policyClassName\fP には、引数なしのコンストラクタを持ち、次のような \f2checkExecCommand\fP メソッドを実装している public クラスを指定します。
.nf
\f3
.fl
public void checkExecCommand(ActivationGroupDesc desc,
.fl
String[] command)
.fl
throws SecurityException;
.fl
\fP
.fi
起動グループを開始する前に、 \f2rmid\fP は、ポリシーの \f2checkExecCommand\fP メソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。 \f2checkExecCommand\fP が \f2SecurityException\fP をスローすると、 \f2rmid\fP はその起動グループを開始せず、オブジェクトの起動を試行している呼び出し側には \f2ActivationException\fP がスローされます。
.TP 2
o
\f3none\fP
.LP
\f2sun.rmi.activation.execPolicy\fP プロパティーの値が「none」の場合、 \f2rmid\fP は、起動グループを開始するコマンドをまったく検証しません。
.RE
.LP
.TP 3
\-log dir
起動システムデーモンがデータベースおよび関連情報を書き込むのに使うディレクトリの名前を指定します。デフォルトでは、rmid コマンドを実行したディレクトリに、 \f2log\fP というログディレクトリが作成されます。
.LP
.TP 3
\-port port
\f2rmid\fP のレジストリが使うポートを指定します。起動システムデーモンは、このレジストリの中で、 \f2java.rmi.activation.ActivationSystem\fP という名前でActivationSystem をバインドします。したがって、ローカルマシン上の \f2ActivationSystem\fP は、次のように \f2Naming.lookup\fP メソッドを呼び出すことによって取得できます。
.nf
\f3
.fl
import java.rmi.*;
.fl
import java.rmi.activation.*;
.fl
.fl
ActivationSystem system; system = (ActivationSystem)
.fl
Naming.lookup("//:\fP\f4port\fP/java.rmi.activation.ActivationSystem");
.fl
.fi
.TP 3
\-stop
\-port オプションによって指定されたポートの、現在の \f2rmid\fP 呼び出しを停止します。 ポートが指定されていない場合は、ポート 1098 で実行されている \f2rmid\fP を停止します。
.RE
.LP
.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。例を示します。
.nf
\f3
.fl
.:/usr/local/java/classes
.fl
\fP
.fi
.RE
.LP
.SH "関連項目"
.LP
.LP
rmic(1)、
.na
\f2CLASSPATH\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath、java(1)
.LP
permission com\&.sun\&.rmi\&.rmid\&.ExecPermission
"/files/apps/rmidcmds/*";
permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission
"\-Djava\&.security\&.policy=/files/policies/group\&.policy";
permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission
"\-Djava\&.security\&.debug=*";
permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission
"\-Dsun\&.rmi\&.*";
};
.fi
.if n \{\
.RE
.\}
最初に付与されている権限は、\fIrmid\fRコマンドに対し、パス名により明示的に指定される\fIjava\fRコマンドの1\&.7\&.0リリースの実行を許可します。デフォルトでは、\fIjava\&.home\fRにあるバージョンの\fIjava\fRコマンドを使用します。\fIrmid\fRコマンドが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目の権限は、\fIrmid\fRコマンドに対して、ディレクトリ\fI/files/apps/rmidcmds\fR内の任意のコマンドの実行権限を許可します。
.sp
3番目に付与されている権限\fIExecOptionPermission\fRは、\fIrmid\fRコマンドに対して、セキュリティ・ポリシー・ファイルを\fI/files/policies/group\&.policy\fRとして定義している起動グループの開始を許可します。次の権限は、起動グループが\fIjava\&.security\&.debug property\fRを使用することを許可しています。最後の権限は、起動グループが\fIsun\&.rmi property\fR名の階層内の任意のプロパティを使用することを許可しています。
.sp
ポリシー・ファイルを指定して\fIrmid\fRコマンドを起動するには、\fIrmid\fRのコマンドラインで\fIjava\&.security\&.policy\fRプロパティを指定する必要があります。次に例を示します。
.sp
\fIrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
<policyClassName>
.sp
デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\fIrmid\fRの起動時に、\fIcheckExecCommand\fRメソッドが所属するクラスの名前を指定して、\fIrmid\fRコマンドが実行するコマンドをチェックすることができます。
.sp
\fIpolicyClassName\fRには、引数なしのコンストラクタを持ち、次のような\fIcheckExecCommand\fRメソッドを実装しているpublicクラスを指定します。
.sp
.if n \{\
.RS 4
.\}
.nf
public void checkExecCommand(ActivationGroupDesc desc, String[] command)
throws SecurityException;
.fi
.if n \{\
.RE
.\}
起動グループを開始する前に、\fIrmid\fRコマンドは、ポリシーの\fIcheckExecCommand\fRメソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\fIcheckExecCommand\fRが\fISecurityException\fRをスローすると、\fIrmid\fRコマンドはその起動グループを開始せず、オブジェクトの起動を試行している呼出し側には\fIActivationException\fRがスローされます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
none
.sp
\fIsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値が\fInone\fRの場合、\fIrmid\fRコマンドは、起動グループを開始するコマンドをまったく検証しません。
.RE
.RE
.PP
\-log \fIdir\fR
.RS 4
起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\fIrmid\fRコマンドを実行したディレクトリに、logというログ・ディレクトリが作成されます。
.RE
.PP
\-port \fIport\fR
.RS 4
レジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\fIjava\&.rmi\&.activation\&.ActivationSystem\fRという名前で\fIActivationSystem\fRをバインドします。ローカル・マシン上の\fIActivationSystem\fRは、次のように\fINaming\&.lookup\fRメソッドを呼び出すことによって取得できます。
.sp
.if n \{\
.RS 4
.\}
.nf
import java\&.rmi\&.*;
import java\&.rmi\&.activation\&.*;
ActivationSystem system; system = (ActivationSystem)
Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem");
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-stop
.RS 4
\fI\-port\fRオプションによって指定されたポートの、現在の\fIrmid\fRコマンドの呼出しを停止します。ポートが指定されていない場合は、このオプションはポート1098で実行されている\fIrmid\fRの呼出しを停止します。
.RE
.SH "環境変数"
.PP
CLASSPATH
.RS 4
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例:
\fI\&.:/usr/local/java/classes\fR
.RE
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Setting the Class Path
.RE
.br
'pl 8.5i
'bp

207
jdk/src/linux/doc/man/ja/rmiregistry.1
View File

@ -1,83 +1,132 @@
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: rmiregistry
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Remote Method Invocation (RMI)ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH rmiregistry 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
rmiregistry \- Java リモートオブジェクトレジストリ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
\f3rmiregistry\fP コマンドは、現在のホストの指定したポート上にリモートオブジェクトレジストリを開始します。 .\"
.RE .pl 99999
.TH "rmiregistry" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)"
.LP .\" -----------------------------------------------------------------
.SH "形式" .\" * Define some portability stuff
.LP .\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
rmiregistry \- 現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIrmiregistry\fR [ \fIport\fR ]
.fl
rmiregistry [\fP\f4port\fP\f3]
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.SH "説明" .\}
.LP .PP
.LP \fIport\fR
\f3rmiregistry\fP コマンドは、現在のホストの指定 \f2port\fP 上にリモートオブジェクトレジストリを作成し、開始します。\f2port\fP の指定を省略した場合、レジストリはポート 1099 で開始します。\f3rmiregistry\fP コマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。例を示します。 .RS 4
.LP リモート・オブジェクト・レジストリを開始する現在のホスト上の\fIport\fRの数。
.LP .RE
\f2rmiregistry&\fP .SH "説明"
.LP .PP
.LP \fIrmiregistry\fRコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを作成し、開始します。portの指定を省略した場合、レジストリはポート1099で開始します。\fIrmiregistry\fRコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。
リモートオブジェクトレジストリは、ブートストラップのネームサービスです。同一ホストの RMI サーバーが、リモートオブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモートホストのクライアントはリモートオブジェクトを検索し、リモートメソッドの呼び出しを行います。 .sp
.LP .if n \{\
.LP .RS 4
レジストリは、一般的に、最初のリモートオブジェクトの位置を指定します。 そこで、アプリケーションはメソッドを呼び出す必要があります。代わって、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。 .\}
.LP .nf
.LP rmiregistry &
\f2java.rmi.registry.LocateRegistry\fP クラスのメソッドは、ローカルホスト、またはローカルホストとポートで動作するレジストリを取得するために使用されます。 .fi
.LP .if n \{\
.LP .RE
\f2java.rmi.Naming\fP クラスの URL ベースのメソッドは、レジストリで動作し、任意のホストおよびローカルホスト上のリモートオブジェクトの検索に使用されます。リモートオブジェクトに単純な (文字列) 名前をバインドしたり、新しい名前をリバインド (古いバインドにオーバーライド) します。またリモートオブジェクトをアンバインドしたり、レジストリにバインドされた URL を出力します。 .\}
.LP .PP
.SH "オプション" リモート・オブジェクト・レジストリは、ブートストラップのネーム・サービスです。同一ホストのRMIサーバーが、リモート・オブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモート・ホストのクライアントはリモート・オブジェクトを検索し、リモート・メソッドの呼出しを行います。
.LP .PP
.RS 3 レジストリは、一般的に、最初のリモート・オブジェクトの位置を指定します。そこで、アプリケーションはメソッドを呼び出す必要があります。その後、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。
.TP 3 .PP
\-J \fIjava\&.rmi\&.registry\&.LocateRegistry\fRクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。
\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\-J と java オプションの間にスペースは入れない)。 .PP
\fIjava\&.rmi\&.Naming\fRクラスのURLベース・メソッドはレジストリに対して操作を実行し、任意のホストおよびローカル・ホストでのリモート・オブジェクトの検索に使用できます。単純名(文字列)をリモート・オブジェクトにバインドし、新しい名前をリモート・オブジェクトに再バインドし(古いバインドをオーバーライド)、リモート・オブジェクトをアンバインドし、レジストリにバインドされているURLをリスト表示します。
.SH "オプション"
.PP
\-J
.RS 4
Javaオプションとともに使用して、\fI\-J\fRの後ろに続くオプションをJavaインタプリタに引き渡します(\fI\-J\fRとオプションの間にスペースは入れません)。
.RE .RE
.LP
.SH "´ØÏ¢¹àÌÜ" .SH "´ØÏ¢¹àÌÜ"
.LP .sp
java(1)、 .RS 4
.na .ie n \{\
\f2java.rmi.registry.LocateRegistry\fP @ \h'-04'\(bu\h'+03'\c
.fi .\}
http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html、および .el \{\
.na .sp -1
\f2java.rmi.Naming\fP @ .IP \(bu 2.3
.fi .\}
http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI「java\&.rmi\&.registry\&.LocateRegistry」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI「java\&.rmi\&.Naming class description」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html)
.RE
.br
'pl 8.5i
'bp

277
jdk/src/linux/doc/man/ja/schemagen.1
View File

@ -1,127 +1,158 @@
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: schemagen
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java Webサービス・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH schemagen 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
schemagen \- XML バインドのための Java(TM) アーキテクチャースキーマジェネレータ .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3仕様バージョン:\fP 2.1 .\"
.br .pl 99999
\f3実装バージョン:\fP 2.1.3 .TH "schemagen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール"
.LP .\" -----------------------------------------------------------------
.SH "schemagen の起動" .\" * Define some portability stuff
.LP .\" -----------------------------------------------------------------
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
スキーマジェネレータを起動するには、ユーザーのプラットフォームの bin ディレクトリ内にある \f2適切な schemagen シェルスクリプト\fP を使用 \f2します\fP 。 .\" http://bugs.debian.org/507673
.LP .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。 .ie \n(.g .ds Aq \(aq
.LP .el .ds Aq '
.LP .\" -----------------------------------------------------------------
また、スキーマジェネレータを実行するための Ant タスクも用意されています。 .\" * set default formatting
.na .\" -----------------------------------------------------------------
\f2schemagen を Ant とともに使用する\fP @ .\" disable hyphenation
.fi .nh
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlための手順を参照してください。 .\" disable justification (adjust text to left margin only)
.LP .ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
schemagen \- Javaクラス内で参照されているネームスペースごとにスキーマを生成します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIschemagen\fR [ \fIoptions\fR ] \fIjava\-files\fR
.fl
% schemagen.sh Foo.java Bar.java ...
.fl
Note: Writing schema1.xsd
.fl
\fP
.fi .fi
.if n \{\
.LP
.LP
ユーザーの Java ソース/クラスがほかのクラスを参照している場合、システムの 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP を使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
.LP
.SS
コマンド行オプション
.LP
.nf
\f3
.fl
使用方法: schemagen [\-options ...] <java files>
.fl
.fl
オプション:
.fl
\-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します。
.fl
\-cp <path> : ユーザー指定ファイルの検索場所を指定します。
.fl
\-classpath <path> : ユーザー指定ファイルの検索場所を指定します。
.fl
\-encoding <encoding> : apt/javac 呼び出しに使用されるエンコーディングを指定します。
.fl
.fl
\-episode <file> : 個別コンパイル用のエピソードファイルを生成します。
.fl
\-version : バージョン情報を表示します。
.fl
\-help : この使用方法に関するメッセージを表示します。
.fl
\fP
.fi
.LP
.SH "生成されるリソースファイル"
.LP
.LP
現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、
.na
\f2スキーマジェネレータの ant タスク\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlを使用してください。
.LP
.SH "名前"
関連項目
.LP
.RS 3
.TP 2
o
スキーマジェネレータの実行 (schemagen): [
.na
\f2コマンド行の命令\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html、
.na
\f2SchemaGen を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
.TP 2
o
.na
\f2XML バインドのための JavaTM アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.PP
\fIjava\-files\fR
.RS 4
処理するJavaクラス・ファイル。
.RE
.SH "説明"
.PP
スキーマ・ジェネレータは、Javaクラス内で参照されているネームスペースごとに1つのスキーマ・ファイルを作成します。現在、生成されるスキーマ・ファイルの名前は制御できません。スキーマ・ファイル名を制御する場合は、http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/schemagenTask\&.htmlにある
「Using SchemaGen with Ant」を参照してください
.PP
プラットフォームのbinディレクトリにある適切な\fIschemagen\fRシェル・スクリプトを使用して、スキーマ・ジェネレータを起動します。現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。
.sp
.if n \{\
.RS 4
.\}
.nf
schemagen\&.sh Foo\&.java Bar\&.java \&.\&.\&.
Note: Writing schema1\&.xsd
.fi
.if n \{\
.RE
.\}
.PP
javaファイルが他のクラスを参照している場合、それらのクラスにシステム\fICLASSPATH\fR環境変数でアクセスできる必要があります。または、クラス・パス・オプションを指定して\fIschemagen\fRコマンド・ラインで指定する必要があります。オプションを参照してください。参照されるファイルにアクセスできない、または参照されるファイルが指定されていない場合、スキーマの生成時にエラーが表示されます。
.SH "オプション"
.PP
\-d \fIpath\fR
.RS 4
\fIschemagen\fRコマンドがプロセッサ生成および\fIjavac\fR生成クラス・ファイルを配置する場所。
.RE
.PP
\-cp \fIpath\fR
.RS 4
\fIschemagen\fRコマンドがユーザー指定ファイルを配置する場所。
.RE
.PP
\-classpath \fIpath\fR
.RS 4
\fIschemagen\fRコマンドがユーザー指定ファイルを配置する場所。
.RE
.PP
\-encoding \fIencoding\fR
.RS 4
\fIapt\fRまたは\fIjavac\fRコマンドの呼出しに使用するエンコーディングを指定します。
.RE
.PP
\-episode \fIfile\fR
.RS 4
コンパイルごとにエピソード・ファイルを生成します。
.RE
.PP
\-version
.RS 4
リリース情報を表示します。
.RE
.PP
\-help
.RS 4
ヘルプ・メッセージを表示します。
.RE
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Using SchemaGen with Ant
.LP (http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/schemagenTask\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Java Architecture for XML Binding (JAXB)
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/xml/jaxb/index\&.html)
.RE
.br
'pl 8.5i
'bp

225
jdk/src/linux/doc/man/ja/serialver.1
View File

@ -1,97 +1,144 @@
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: serialver
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Remote Method Invocation (RMI)ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH serialver 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
serialver \- シリアルバージョンコマンド .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。 .\"
.LP .pl 99999
.SH "形式" .TH "serialver" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)"
.LP .\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
serialver \- 指定したクラスのシリアル・バージョンUIDを戻します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIserialver\fR [ \fIoptions\fR ] [ \fIclassnames\fR ]
.fl
\fP\f3serialver\fP [ options ] [ classnames ]
.fl
.fi .fi
.if n \{\
.LP .RE
.RS 3 .\}
.TP 3 .PP
options \fIoptions\fR
このドキュメントで説明されているコマンド行オプションです。 .RS 4
.TP 3 コマンドライン・オプション。オプションを参照してください。
classnames .RE
1 つ以上のクラス名です。 .PP
\fIclassnames\fR
.RS 4
\fIserialVersionUID\fRを戻すクラスです。
.RE .RE
.LP
.SH "説明" .SH "説明"
.LP .PP
.LP \fIserialver\fRコマンドは、1つ以上のクラスの\fIserialVersionUID\fRを、展開しているクラスへコピーするのに適した形式で返します。引数なしで呼び出された場合、\fIserialver\fRコマンドは使用率行を出力します。
\f3serialver\fP は、1 つ以上のクラスの \f2serialVersionUID\fP を、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-classpath \fIpath\-files\fR
.TP 3 .RS 4
\-classpath <: で区切られたディレクトリと zip や jar ファイル> アプリケーションのクラスおよびリソースの検索パスを設定します。クラスとリソースをコロン(:)で区切ります。
アプリケーションのクラスおよびリソースの検索パスを設定します。
.RE .RE
.PP
.LP \-show
.RS 3 .RS 4
.TP 3 簡単なユーザー・インタフェースを表示します。完全指定のクラス名を入力して、Enterキーか「表示」ボタンを押し、\fIserialVersionUID\fRを表示します。
\-show
簡単なユーザーインタフェースを表示します。完全指定のクラス名を入力して、Enter キーか「Show」ボタンを押し、シリアルバージョン UID を表示します。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE .RE
.PP
.LP \-J\fIoption\fR
.SH "注" .RS 4
.LP Java仮想マシンに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.LP .RE
\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティーマネージャーの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティーマネージャーを設定できます。 .SH "注意"
.LP .PP
.LP \fIserialver\fRコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\fIserialver\fRコマンドを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。
\f2\-J\-Djava.security.manager\fP .sp
.LP .if n \{\
.LP .RS 4
また、必要であれば、次のオプションを使ってセキュリティーポリシーを指定できます。 .\}
.LP .nf
.LP \-J\-Djava\&.security\&.manager
\f2\-J\-Djava.security.policy=<policy file>\fP
.LP
.SH "関連項目"
.LP
.LP
.na
\f2java.io.ObjectStreamClass\fP @
.fi .fi
http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html .if n \{\
.LP .RE
.\}
.PP
必要であれば、次のオプションを使用してセキュリティ・ポリシーを指定できます。
.sp
.if n \{\
.RS 4
.\}
.nf
\-J\-Djava\&.security\&.policy=<policy file>
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
policytool(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
http://docs\&.oracle\&.com/javase/8/docs/api/java/io/ObjectStreamClass\&.htmlにある
\fIjava\&.io\&.ObjectStream\fRクラス記述
.RE
.br
'pl 8.5i
'bp

296
jdk/src/linux/doc/man/ja/servertool.1
View File

@ -1,113 +1,199 @@
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: servertool
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java IDLおよびRMI-IIOPツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH servertool 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
servertool \- Java(TM) IDL サーバーツール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
\f3servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。 .\" questions.
.SH "形式" .\"
.LP .pl 99999
.TH "servertool" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
servertool \- 開発者が永続サーバーを登録、登録解除、起動、停止するための使いやすいユーザー・インタフェースを提供します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR]
.fl
servertool \-ORBInitialPort \fP\f4nameserverport\fP\f3 \fP\f3options\fP\f3 [ \fP\f3commands\fP\f3 ]
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.LP .\}
コマンドを入力しないで \f2servertool\fP を起動すると、コマンド行ツールとして \f2servertool >\fP プロンプトが表示されます。\f2servertool >\fP プロンプトにコマンドを入力します。 .PP
.LP \fIoptions\fR
.LP .RS 4
コマンドを入力して \f2servertool\fP を起動すると、Java IDL サーバーツールが起動し、コマンドを実行して終了します。 コマンドライン・オプション。オプションを参照してください。
.LP .RE
.LP .PP
\f2\-ORBInitialPort\fP \f2nameserverport\fP オプションは\f3必須\fPです。 \f2nameserverport\fP の値には、\f2orbd\fP が実行され、着信要求を待機しているポートを指定する必要があります。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、\f2nameserverport\fPとして 1024 以上のポート番号を使用することをお勧めします。 commands
.LP .RS 4
コマンドライン・コマンド。コマンドを参照してください。
.RE
.PP
\fIservertool\fR\fIservertool >\fR\fIservertool >\fR
.SH "説明" .SH "説明"
.LP .PP
.LP \fIservertool\fRコマンドは、開発者が永続サーバーを登録、登録解除、起動、停止するためのコマンドライン・インタフェースを提供します。コマンドライン・コマンドを使用すると、サーバーに関する様々な統計情報を取得できます。コマンドを参照してください。
\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。
.LP
.SH "オプション" .SH "オプション"
.LP .PP
.RS 3 \-ORBInitialHost \fInameserverhost\fR
.TP 3 .RS 4
\-ORBInitialHost nameserverhost このオプションは必須です。ネーム・サーバーが実行され、着信リクエストをリスニングするホスト・マシンを指定します。\fInameserverhost\fR値は、\fIorb\fRが実行され、リクエストをリスニングしているポートを指定する必要があります。このオプションを指定しない場合、値はデフォルトで\fIlocalhost\fRに設定されます。\fIorbd\fRと\fIservertool\fRが異なるマシン上で実行されている場合は、\fIorbd\fRが実行されているホストの名前またはIPアドレスを指定する必要があります。
ネームサーバーが、実行され、着信要求を待機しているホストマシンを指定します。このオプションを指定しない場合、\f2nameserverhost\fP はデフォルトで \f2localhost\fP に設定されます。\f2orbd\fP と \f2servertool\fP が異なるマシン上で実行されている場合は、\f2orbd\fP が実行されているホストの名前と IP アドレスを指定する必要があります。 .sp
.TP 3 \fB注意:\fR
\-Joption Oracle Solarisでは、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。\fInameserverport\fR値には、1024以上のポート番号を使用することをお薦めします。
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。 .RE
.PP
\-J\fIoption\fR
.RS 4
Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE .RE
.LP
.SH "コマンド" .SH "コマンド"
.LP .PP
.RS 3 \fIservertool\fRコマンドは、コマンドライン・コマンドを使用して、または使用せずに起動できます。
.TP 3 .sp
register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ] .RS 4
Object Request Broker Daemon (ORBD) に新規持続サーバーを登録します。サーバーが未登録の場合、登録して起動します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でインストールメソッドが呼び出されます。このインストールメソッドは、\f2public static void install(org.omg.CORBA.ORB)\fP になっている必要があります。インストールメソッドは、オプションであり、データベーススキーマの作成などの独自のサーバーインストール動作を開発者が指定できます。 .ie n \{\
.TP 3 \h'-04'\(bu\h'+03'\c
unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> .\}
サーバー ID またはアプリケーション名を使用して、ORBD のサーバーの登録を解除します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でアンインストールメソッドが呼び出されます。このアンインストールメソッドは、\f2public static void uninstall(org.omg.CORBA.ORB)\fP になっている必要があります。アンインストールメソッドは、オプションであり、インストールメソッドの動作の取り消しなどの独自のサーバーアンインストール動作を開発者が指定できます。 .el \{\
.TP 3 .sp -1
getserverid \-applicationName\ <application\ name> .IP \(bu 2.3
アプリケーションに関連付けられているサーバー ID を返します。 .\}
.TP 3 \fIservertool\fRの起動時にコマンドを指定しなかった場合、コマンドライン・ツールにコマンド入力を求める\fIservertool\fRプロンプトが表示されます:
list \fIservertool >\fR。
ORBD に登録されているすべての持続サーバーに関する情報を一覧表示します。 .RE
.TP 3 .sp
listappnames .RS 4
現在 ORBD に登録されているすべてのサーバーのアプリケーション名を一覧表示します。 .ie n \{\
.TP 3 \h'-04'\(bu\h'+03'\c
listactive .\}
ORDB によって起動され、現在実行されているすべての持続サーバーに関する情報を一覧表示します。 .el \{\
.TP 3 .sp -1
locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ] .IP \(bu 2.3
登録されたサーバーで作成したすべての ORB の特定の型について端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。端点の型が指定されていない場合、サーバーの ORB ごとに関連付けられている plain 型 または non\-protected 型の端点が返されます。 .\}
.TP 3 \fIservertool\fRの起動時にコマンドを指定した場合、Java IDL Server Toolが起動してコマンドを実行し、終了します。
locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ] .RE
登録されたサーバーの特定の ORB で登録された端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。\f2orbid\fP が指定されていない場合は、デフォルト値の「""」が\f2orbid\fPに割り当てられます。ORB が空文字列の \f2orbid\fP で作成されている場合、登録したポートがすべて返されます。 .PP
.TP 3 register \-server \fIserver\-class\-name\fR \-classpath \fIclasspath\-to\-server\fR [ \-applicationName \fIapplication\-name\fR \-args \fIargs\-to\-server\fR \-vmargs \fIflags\-for\-JVM\fR ]
orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> .RS 4
サーバー上に定義された ORB の ORBId を一覧表示します。ORBId はサーバーで作成された ORB の文字列名です。サーバーが実行されていない場合、起動されます。 Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\fI\-server\fRオプションで識別されるサーバーの\fIメイン\fR・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\fIpublic static void install(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。インストール・メソッドはオプションであり、開発者はデータベース・スキーマの作成など独自のサーバー・インストール動作を指定できます。
.TP 3 .RE
shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> .PP
ORBD に登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\f2\-serverid\fP パラメータまたは \f2\-applicationName\fP パラメータで指定されたクラス内に定義された \f2shutdown()\fP メソッドも呼び出されてサーバープロセスを正しく停止します。 unregister \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR
.TP 3 .RS 4
startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> サーバーIDまたはアプリケーション名で、サーバーをORBDから登録解除します。このコマンドによって、\fI\-server\fRオプションで識別されるサーバーの\fIメイン\fR・クラス内でアンインストール・メソッドが呼び出されます。
ORBD に登録されたサーバーを起動します。サーバーが実行されていない場合は、このコマンドでサーバーを起動します。サーバーがすでに実行されている場合は、ユーザーにエラーメッセージが返されます。 \fIuninstall\fRメソッドは、\fIpublic static void uninstall(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。\fIuninstall\fRメソッドはオプションであり、開発者は\fIinstall\fRメソッドの動作の取消など、独自のサーバー・アンインストール動作を指定できます。
.TP 3 .RE
help .PP
サーバーがサーバーツールで使用できるすべてのコマンドを表示します。 getserverid \-applicationName \fIapplication\-name\fR
.TP 3 .RS 4
quit \fIapplication\-name\fR値に対応するサーバーIDを返します。
サーバーツールを終了します。 .RE
.PP
list
.RS 4
ORBDに登録されているすべての永続サーバーに関する情報を一覧表示します。
.RE
.PP
listappnames
.RS 4
現在ORBDに登録されているすべてのサーバーのアプリケーション名を一覧表示します。
.RE
.PP
listactive
.RS 4
ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。
.RE
.PP
locate \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-endpointType \fIendpointType\fR ]
.RS 4
登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fIendpointType\fR値が指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。
.RE
.PP
locateperorb \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-orbid \fIORB\-name\fR ]
.RS 4
登録されたサーバーの特定のObject Request Broker (ORB)で登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fIorbid\fRが指定されていない場合、デフォルト値の\fI""\fRが\fIorbid\fRに割り当てられます。ORBが空文字列の\fIorbid\fRで作成されている場合、登録したポートがすべて返されます。
.RE
.PP
orblist \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR
.RS 4
サーバー上に定義されたORBの\fIORBId\fRを一覧表示します。\fIORBId\fRはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。
.RE
.PP
shutdown \-serverid \fIserver\-id\fR | \-applicationName application\-name
.RS 4
ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\fI\-serverid\fRパラメータまたは\fI\-applicationName\fRパラメータで指定されたクラス内に定義された\fIshutdown\fRメソッドも呼び出されてサーバー・プロセスを停止します。
.RE
.PP
startup \-serverid \fIserver\-id\fR | \-applicationName application\-name
.RS 4
ORBDに登録されたサーバーを起動またはアクティブ化します。サーバーが実行されていない場合、このコマンドがサーバーを起動します。サーバーがすでに実行されている場合は、エラー・メッセージが表示されます。
.RE
.PP
help
.RS 4
\fIservertool\fRコマンドを介してサーバーが利用できるすべてのコマンドをリストします。
.RE
.PP
quit
.RS 4
\fIservertool\fRコマンドを終了します。
.RE .RE
.LP
.SH "関連項目" .SH "関連項目"
.LP .sp
orbd(1) .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
orbd(1)
.RE
.br
'pl 8.5i
'bp

882
jdk/src/linux/doc/man/ja/tnameserv.1
View File

@ -1,495 +1,425 @@
." Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: tnameserv
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java IDLおよびRMI-IIOPツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH tnameserv 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
Java IDL: 一時ネームサービス \- \f2tnameserv\fP .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.LP .\" questions.
このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には、Object Request Broker Daemon (ORBD) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャーを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD を使用していますが、一時ネームサービスを使用する例では、\f2orbd\fP の代わりに \f2tnameserv\fP を使用できます。\f2orbd\fP ツールの詳細については、orbd の orbd(1)または .\"
.na .pl 99999
\f2ORBD に含まれる Java IDL ネームサービス\fP @ .TH "tnameserv" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
tnameserv \- インタフェース定義言語(IDL)。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fItnameserve\fR \fI\-ORBInitialPort\fR [ \fInameserverport\fR ]
.fi .fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。 .if n \{\
.LP
.LP
ここでは、以下の項目について説明します。
.LP
.RS 3
.TP 2
o
Java\ IDL 一時ネームサービス
.TP 2
o
Java\ IDL 一時ネームサービスの起動
.TP 2
o
Java\ IDL 一時ネームサービスの停止
.TP 2
o
サンプルクライアント: 名前空間へのオブジェクトの追加
.TP 2
o
サンプルクライアント: 名前空間のブラウズ
.RE .RE
.\}
.LP .PP
.SH "Java IDL 一時ネームサービス" \-ORBInitialPort \fInameserverport\fR
.LP .RS 4
.LP ネーミング・サービスがORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。
CORBA の COS (Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDL の一時ネームサービスである \f2tnameserv\fP は、COS ネームサービスの仕様を単純な形で実装したものです。
.LP
.LP
オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納されます。名前空間において、初期ネーミングコンテキストは唯一の持続的バインディングです。それ以外のネーミングコンテキストは、Java IDL のネーミングサービスプロセスが停止し、再起動されると失われます。
.LP
.LP
アプレットまたはアプリケーションから COS ネームサービスを使用するためには、その ORB はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの文字列化された初期ネーミングコンテキストにアクセスできなければなりません。ネームサービスは、Java IDL のネームサービスでもその他の COS 準拠のネームサービスでもかまいません。
.LP
.SH "Java IDL 一時ネームサービスの起動"
.LP
.LP
Java IDL ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java\ IDL 製品をインストールすると、Java\ IDL ネームサービスを起動するスクリプト (Solaris: \f2tnameserv\fP) または実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。バックグラウンドで動作するように、ネームサービスを起動してください。
.LP
.LP
特に指定しない場合、Java IDL ネームサービスは、ORB の \f2resolve_initial_references()\fP メソッドと \f2list_initial_references()\fP メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
.LP
.nf
\f3
.fl
tnameserv \-ORBInitialPort \fP\f4nameserverport\fP\f3&
.fl
\fP
.fi
.LP
.LP
ネームサーバーポートを指定しない場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアの実行時は、1024 より小さいポートでプロセスを開始する場合、root ユーザーになる必要があります。このため、1024 または 1024 よりも大きいポート番号を使用することをお勧めします。1050 のように別のポートを指定し、ネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルで次のように入力します。
.LP
.nf
\f3
.fl
tnameserv \-ORBInitialPort 1050&
.fl
\fP
.fi
.LP
.LP
Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
.fl
start tnameserv \-ORBInitialPort 1050
.fl
\fP
.fi
.LP
.LP
ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティーに新しいポート番号を設定します。
.LP
.SS
異なるマシン上でのクライアントとサーバーの実行
.LP
.LP
Java IDL と RMI\-IIOP のほとんどのチュートリアルでは、ネームサービス、サーバー、およびクライアントはすべて開発用のマシン上で実行されます。実際に配備する場合には、クライアントとサーバーを、ネームサービスとは異なるホスト上で実行することが多くなります。
.LP
.LP
クライアントとサーバーがネームサービスを見つけるには、クライアントとサーバーが、ネームサービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP プロパティーと \f2org.omg.CORBA.ORBInitialHost\fP プロパティーをネームサービスが実行されているポートの番号とマシンの名前に設定します。この例は、
.na
\f2「RMI\-IIOP を使った Hello World の例」に示されています。\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlコマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使用して、クライアントとサーバーに対してネームサービスを探す場所を指定することもできます。
.na
\f2「Java IDL: 2 台のマシン上で実行する Hello World プログラム」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html には、コマンド行オプションを使用して指定する方法が示されています。
.LP
.LP
たとえば、一時ネームサービス \f2tnameserv\fP が、ホスト \f2nameserverhost\fP のポート 1050 上で実行されているとします。さらに、クライアントがホスト \f2clienthost\fP 上で実行され、サーバーはホスト \f2serverhost\fP 上で実行されているとします。
.LP
.RS 3
.TP 2
o
次のように、ホスト \f2nameserverhost\fP 上で \f2tnameserv\fP を起動します。
.nf
\f3
.fl
tnameserv \-ORBInitialPort 1050
.fl
.fl
\fP
.fi
.TP 2
o
\f2serverhost\fP 上でサーバーを起動します。
.nf
\f3
.fl
java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
.fl
\fP
.fi
.TP 2
o
\f2clienthost\fP 上でクライアントを起動します。
.nf
\f3
.fl
java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
.fl
\fP
.fi
.RE .RE
.SH "説明"
.LP .PP
.SS Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fIorbd\fRのかわりに\fItnameserv\fRを使用できます。
\-J オプション .PP
.LP http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlにある
このコマンド行オプションは、\f2tnameserve\fP とともに使用できます。 orbd(1)または「Naming Service」を参照してください。
.RS 3 .PP
.TP 3 CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fItnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。
\-Joption .PP
Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。 オブジェクト参照はネームスペースに名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・バインディングと呼ばれます。ネーム・バインディングはネーミング・コンテキストに組み込むことができます。ネーミング・コンテキストはネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは初期ネーミング・コンテキストの下に格納されます。初期ネーミング・コンテキストは、ネームスペースの唯一の永続バインディングです。Java IDLネーミング・サービス・プロセスを停止して再起動すると、残りのネームスペースは失われます。
.PP
アプレットまたはアプリケーションからCOSネーミング・サービスを使用するためには、そのORBがネーミング・サービスが動作しているホストのポートを知っているか、そのネーミング・サービスの初期ネーミング・コンテキスト文字列にアクセスできる必要があります。ネーム・サービスは、Java IDLのネーム・サービスでもその他のCOS準拠のネーム・サービスでもかまいません。
.SS "ネーミング・サービスの起動"
.PP
Java IDLネーム・サービスは、ネーム・サービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java IDL製品をインストールすると、Java IDLネーミング・サービスを起動するスクリプト(Oracle Solaris:
\fItnameserv\fR)または実行可能ファイル(Windows:
\fItnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。
.PP
特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。
.sp
.if n \{\
.RS 4
.\}
.nf
tnameserv \-ORBInitialPort nameserverport&
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
.SH "Java IDL 一時ネームサービスの停止" ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、UNIXコマンド・シェルで次のように入力します。
.LP .sp
.LP .if n \{\
Java IDL ネームサービスを停止するには、Unix の場合は、\f2kill\fP などのオペレーティングシステムのコマンドを使い、Windows の場合は、\f2Ctrl\-C\fP を使います。ネームサービスを明示的に停止するまでは、呼び出し待機状態が続きます。なお、サービスを終了させると、Java IDL ネームサービスに登録されている名前は失われます。 .RS 4
.LP .\}
.SH "サンプルクライアント: 名前空間へのオブジェクトの追加"
.LP
.LP
次に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
.LP
.nf .nf
\f3 tnameserv \-ORBInitialPort 1050&
.fl
\fP\f3
.fl
\fP\f4初期\fP\f3
.fl
\fP\f4ネーミングコンテキスト\fP\f3
.fl
/ \\
.fl
/ \\
.fl
plans \fP\f4Personal\fP\f3
.fl
/ \\
.fl
/ \\
.fl
calendar schedule\fP
.fl
.fi .fi
.if n \{\
.LP .RE
.LP .\}
この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照を含むネーミングコンテキストです。 .PP
.LP WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 start tnameserv \-ORBInitialPort 1050
.fl
import java.util.Properties;
.fl
import org.omg.CORBA.*;
.fl
import org.omg.CosNaming.*;
.fl
.fl
public class NameClient
.fl
{
.fl
public static void main(String args[])
.fl
{
.fl
try {
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。 .\}
.PP
ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。
.SS "異なるホスト上でのサーバーとクライアントの実行"
.PP
Java IDLとRMI\-IIOPのほとんどのチュートリアルでは、ネーミング・サービス、サーバーおよびクライアントはすべて開発用のマシン上で実行されます。実際にデプロイメントする場合には、クライアントとサーバーを、ネーミング・サービスとは異なるホスト・マシン上で実行することが多くなります。
.PP
クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fIorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi\-iiop/rmiiiopexample\&.html)に示されています
.PP
コマンドライン・オプション\fI\-ORBInitialPort nameserverport#\fRと\fI\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンドライン・オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」
を参照してください
.PP
たとえば、一時ネーム・サービス\fItnameserv\fRが、ホスト\fInameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fIclienthost\fR上で実行され、サーバーはホスト\fIserverhost\fR上で実行されているとします。
.PP
ホスト\fInameserverhost\fR上で\fItnameserv\fRを起動します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 tnameserv \-ORBInitialPort 1050
.fl
Properties props = new Properties();
.fl
props.put("org.omg.CORBA.ORBInitialPort", "1050");
.fl
ORB orb = ORB.init(args, props);
.fl
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
次のコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この objref には、あとでさまざまな名前を割り当てて名前空間に追加します。 .\}
.PP
\fIserverhost\fR上でサーバーを起動します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
.fl
NamingContext ctx =
.fl
NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fl
NamingContext objref = ctx;
.fl
.fl
\fP
.fi .fi
.if n \{\
.RE
.\}
.PP
.LP \fIclienthost\fR上でクライアントを起動します。
次のコードでは、text 型の名前 plans を作成し、それをダミーのオブジェクト参照にバインドします。その後、rebind を使用して初期ネーミングコンテキストの下に \f2plans を追加しています\fP。 \f2rebind\fP メソッドを使用すれば、bind を使用した場合に発生する例外を発生させずに、 \f2このプログラムを何度も繰り返し実行できます\fP。 .sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost
.fl
NameComponent nc1 = new NameComponent("plans", "text");
.fl
NameComponent[] name1 = {nc1};
.fl
ctx.rebind(name1, objref);
.fl
System.out.println("plans rebind sucessful!");
.fl
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
次のコードでは、directory 型の Personal というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。 .\}
.SS "ネーミング・サービスの停止"
.PP
Java IDLネーミング・サービスを停止するには、Unixの場合は、\fIkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fI[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。
.SH "オプション"
.PP
\-J\fIoption\fR
.RS 4
Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE
.SH "例"
.SS "ネームスペースへのオブジェクトの追加"
.PP
次の例では、ネームスペースに名前を追加する方法を示します。このサンプル・プログラムは、このままの状態で完全に動作する一時ネーム・サービス・クライアントで、次のような単純なツリーを作成するものです。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 Initial Naming Context
.fl plans
NameComponent nc2 = new NameComponent("Personal", "directory"); Personal
.fl calendar
NameComponent[] name2 = {nc2}; schedule
.fl
NamingContext ctx2 = ctx.bind_new_context(name2);
.fl
System.out.println("new naming context added..");
.fl
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
残りのコードでは、ダミーのオブジェクト参照を schedule と calendar という名前でネーミングコンテキスト "Personal" (\f3ctx2\fP) にバインドします。 .\}
.PP
この例で、\fIplans\fRはオブジェクト参照、\fIPersonal\fRは\fIcalendar\fRと\fIschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 import java\&.util\&.Properties;
.fl import org\&.omg\&.CORBA\&.*;
NameComponent nc3 = new NameComponent("schedule", "text"); import org\&.omg\&.CosNaming\&.*;
.fl
NameComponent[] name3 = {nc3};
.fl
ctx2.rebind(name3, objref);
.fl
System.out.println("schedule rebind sucessful!");
.fl
.fl
NameComponent nc4 = new NameComponent("calender", "text");
.fl
NameComponent[] name4 = {nc4};
.fl
ctx2.rebind(name4, objref);
.fl
System.out.println("calender rebind sucessful!");
.fl
.fl
.fl
} catch (Exception e) {
.fl
e.printStackTrace(System.err);
.fl
}
.fl
}
.fl
}
.fl
\fP
.fi
.LP
.SH "サンプルクライアント: 名前空間のブラウズ"
.LP
.LP
次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
.LP
.nf
\f3
.fl
import java.util.Properties;
.fl
import org.omg.CORBA.*;
.fl
import org.omg.CosNaming.*;
.fl
.fl
public class NameClientList
.fl
{
.fl
public static void main(String args[])
.fl
{
.fl
try {
.fl
\fP
.fi
.LP
前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントシステムに知らせます。
.nf
\f3
.fl
.fl
Properties props = new Properties();
.fl
props.put("org.omg.CORBA.ORBInitialPort", "1050");
.fl
ORB orb = ORB.init(args, props);
.fl
.fl
.fl
\fP
.fi
.LP
次のコードでは、初期ネーミングコンテキストを取得しています。
.nf
\f3
.fl
NamingContext nc =
.fl
NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fl
.fl
\fP
.fi
.LP
\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。
.nf
\f3
.fl
BindingListHolder bl = new BindingListHolder();
.fl
BindingIteratorHolder blIt= new BindingIteratorHolder();
.fl
nc.list(1000, bl, blIt);
.fl
.fl
\fP
.fi
.LP
次のコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
.nf
\f3
.fl
Binding bindings[] = bl.value;
.fl
if (bindings.length == 0) return;
.fl
.fl
\fP
.fi
.LP
残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
.nf
\f3
.fl
for (int i=0; i < bindings.length; i++) {
.fl
.fl
// get the object reference for each binding
.fl
org.omg.CORBA.Object obj = nc.resolve(bindings[i].binding_name);
.fl
String objStr = orb.object_to_string(obj);
.fl
int lastIx = bindings[i].binding_name.length\-1;
.fl
.fl
// check to see if this is a naming context
.fl
if (bindings[i].binding_type == BindingType.ncontext) {
.fl
System.out.println( "Context: " +
.fl
bindings[i].binding_name[lastIx].id);
.fl
} else {
.fl
System.out.println("Object: " +
.fl
bindings[i].binding_name[lastIx].id);
.fl
}
.fl
}
.fl
.fl
} catch (Exception e) {
.fl
e.printStackTrace(System.err);
.fl
}
.fl
}
.fl
}
.fl
\fP
.fi
.LP
public class NameClient {
public static void main(String args[]) {
try {
.fi
.if n \{\
.RE
.\}
.PP
ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。
.sp
.if n \{\
.RS 4
.\}
.nf
Properties props = new Properties();
props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");
ORB orb = ORB\&.init(args, props);
.fi
.if n \{\
.RE
.\}
.PP
次のコードでは、初期ネーミング・コンテキストを取得し、それを\fIctx\fRに代入します。2行目では、\fIctx\fRをダミーのオブジェクト参照\fIobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。
.sp
.if n \{\
.RS 4
.\}
.nf
NamingContext ctx =
NamingContextHelper\&.narrow(
orb\&.resolve_initial_references("NameService"));
NamingContext objref = ctx;
.fi
.if n \{\
.RE
.\}
.PP
次のコードでは、\fItext\fRタイプの名前\fIplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fIrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fIplans\fRを追加しています。\fIrebind\fRメソッドを使用すれば、\fIbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。
.sp
.if n \{\
.RS 4
.\}
.nf
NameComponent nc1 = new NameComponent("plans", "text");
NameComponent[] name1 = {nc1};
ctx\&.rebind(name1, objref);
System\&.out\&.println("plans rebind successful!");
.fi
.if n \{\
.RE
.\}
.PP
次のコードでは、\fIdirectory\fRタイプの\fIPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fIctx2\fRを\fIname\fRにバインドし、初期ネーミング・コンテキストに追加します。
.sp
.if n \{\
.RS 4
.\}
.nf
NameComponent nc2 = new NameComponent("Personal", "directory");
NameComponent[] name2 = {nc2};
NamingContext ctx2 = ctx\&.bind_new_context(name2);
System\&.out\&.println("new naming context added\&.\&.");
.fi
.if n \{\
.RE
.\}
.PP
残りのコードでは、ダミーのオブジェクト参照を\fIschedule\fRと\fIcalendar\fRという名前でネーミング・コンテキスト\fIPersonal\fR(\fIctx2\fR)にバインドします。
.sp
.if n \{\
.RS 4
.\}
.nf
NameComponent nc3 = new NameComponent("schedule", "text");
NameComponent[] name3 = {nc3};
ctx2\&.rebind(name3, objref);
System\&.out\&.println("schedule rebind successful!");
NameComponent nc4 = new NameComponent("calender", "text");
NameComponent[] name4 = {nc4};
ctx2\&.rebind(name4, objref);
System\&.out\&.println("calender rebind successful!");
} catch (Exception e) {
e\&.printStackTrace(System\&.err);
}
}
}
.fi
.if n \{\
.RE
.\}
.SS "ネームスペースの参照"
.PP
次のサンプル・プログラムでは、ネームスペースをブラウズする方法を示します。
.sp
.if n \{\
.RS 4
.\}
.nf
import java\&.util\&.Properties;
import org\&.omg\&.CORBA\&.*;
import org\&.omg\&.CosNaming\&.*;
public class NameClientList {
public static void main(String args[]) {
try {
.fi
.if n \{\
.RE
.\}
.PP
ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。
.sp
.if n \{\
.RS 4
.\}
.nf
Properties props = new Properties();
props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");
ORB orb = ORB\&.init(args, props);
.fi
.if n \{\
.RE
.\}
.PP
次のコードでは、初期ネーミング・コンテキストを取得しています。
.sp
.if n \{\
.RS 4
.\}
.nf
NamingContext nc =
NamingContextHelper\&.narrow(
orb\&.resolve_initial_references("NameService"));
.fi
.if n \{\
.RE
.\}
.PP
\fIlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fIBindingListHolder\fRに返されます。残りのバインディングは、\fIBindingIteratorHolder\fRに返されます。
.sp
.if n \{\
.RS 4
.\}
.nf
BindingListHolder bl = new BindingListHolder();
BindingIteratorHolder blIt= new BindingIteratorHolder();
nc\&.list(1000, bl, blIt);
.fi
.if n \{\
.RE
.\}
.PP
次のコードでは、返された\fIBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。
.sp
.if n \{\
.RS 4
.\}
.nf
Binding bindings[] = bl\&.value;
if (bindings\&.length == 0) return;
.fi
.if n \{\
.RE
.\}
.PP
残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
.sp
.if n \{\
.RS 4
.\}
.nf
for (int i=0; i < bindings\&.length; i++) {
// get the object reference for each binding
org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name);
String objStr = orb\&.object_to_string(obj);
int lastIx = bindings[i]\&.binding_name\&.length\-1;
// check to see if this is a naming context
if (bindings[i]\&.binding_type == BindingType\&.ncontext) {
System\&.out\&.println("Context: " +
bindings[i]\&.binding_name[lastIx]\&.id);
} else {
System\&.out\&.println("Object: " +
bindings[i]\&.binding_name[lastIx]\&.id);
}
}
} catch (Exception e) {
e\&.printStackTrace(System\&.err)
}
}
}
.fi
.if n \{\
.RE
.\}
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
orbd(1)
.RE
.br
'pl 8.5i
'bp

371
jdk/src/linux/doc/man/ja/unpack200.1
View File

@ -1,178 +1,201 @@
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: unpack200
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Javaデプロイメント・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH unpack200 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.SH "名前" .\"
unpack200 \- JAR アンパックツール .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.LP .\" or visit www.oracle.com if you need additional information or have any
.RS 3 .\" questions.
.TP 2 .\"
o .pl 99999
形式 .TH "unpack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール"
.TP 2 .\" -----------------------------------------------------------------
o .\" * Define some portability stuff
説明 .\" -----------------------------------------------------------------
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .\" http://bugs.debian.org/507673
オプション .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.TP 2 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
o .ie \n(.g .ds Aq \(aq
終了ステータス .el .ds Aq '
.TP 2 .\" -----------------------------------------------------------------
o .\" * set default formatting
関連項目 .\" -----------------------------------------------------------------
.TP 2 .\" disable hyphenation
o .nh
注意事項 .\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
unpack200 \- pack200(1)で作成されたパック・ファイルを、WebデプロイメントのためにJARファイルに変換します。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf
\fIunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR
.fi
.if n \{\
.RE .RE
.\}
.LP .PP
.SH "形式" \fIoptions\fR
.LP .RS 4
.LP コマンドライン・オプション。オプションを参照してください。
\f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
.LP
.LP
オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.TP 3
input\-file
入力ファイルの名前。入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
.TP 3
JAR\-file
出力 JAR ファイル名。
.RE .RE
.PP
.LP \fIinput\-file\fR
.SH " 説明" .RS 4
.LP 入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。入力ファイルには、\fIpack200\fR(1)で作成されたJARファイルを指定することもできます(手間は\fI0\fRです)。この場合、入力ファイルの内容はPack2000マーカーで出力JARファイルにコピーされます。
.LP .RE
\f2unpack200\fP は、pack200(1) で作成されたパックファイルを JAR ファイルに変換する \f2ネイティブ実装\fPです。一般的な使用方法: .PP
.LP \fIJAR\-file\fR
.LP .RS 4
\f2% unpack200 myarchive.pack.gz myarchive.jar\fP 出力JARファイル名。
.LP .RE
.LP .SH "説明"
この例では、 \f2デフォルトの unpack200 設定で、myarchive.pack.gz\fP から \f2myarchive.jar\fP が \f2作成されます\fP 。 .PP
.LP \fIunpack200\fRコマンドは、\fIpack200\fR\fI(1)\fRで作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法は次のとおりです。次の例では、デフォルトの\fIunpack200\fRコマンド設定で、\fImyarchive\&.jar\fRファイルが\fImyarchive\&.pack\&.gz\fRから作成されます。
.sp
.if n \{\
.RS 4
.\}
.nf
unpack200 myarchive\&.pack\&.gz myarchive\&.jar
.fi
.if n \{\
.RE
.\}
.SH "オプション" .SH "オプション"
.LP .PP
.LP \-Hvalue \-\-deflate\-hint=\fIvalue\fR
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP .RS 4
.LP JARファイル内のすべてのエントリに\fItrue\fR、\fIfalse\fRまたは\fIkeep\fRのデフレーションを設定します。デフォルト・モードは\fIkeep\fRです。値が\fItrue\fRまたは\fIfalse\fR場合、\fI\-\-deflate=hint\fRオプションはデフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。
.LP
JAR ファイル内のすべてのエントリに \f2true\fP 、 \f2false\fP、 \f2keep\fP としてデフレーションを設定します。デフォルトモードは \f2keep\fP です。 \f2true\fP または \f2false 場合、\fPデフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
.LP
.LP
\f4\-r \-\-remove\-pack\-file\fP
.LP
.LP
入力パックファイルを削除します。
.LP
.LP
\f4\-v \-\-verbose\fP
.LP
.LP
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
.LP
\f4\-q \-\-quiet\fP
.LP
.LP
メッセージを表示せずに動作します。
.LP
.LP
\f4\-lfilename \-\-log\-file=\fP\f2filename\fP
.LP
.LP
出力メッセージのログファイルを指定します。
.LP
.LP
\f4\-? \-h \-\-help\fP
.LP
.LP
このコマンドに関するヘルプ情報を出力します。
.LP
.LP
\f4\-V \-\-version\fP
.LP
.LP
このコマンドに関するバージョン情報を出力します。
.LP
.LP
\f4\-J\fP\f2option\fP
.LP
.LP
unpack200 によって呼び出される Java 起動ツールに \f2オプション\fP を \f2渡します\fP。
.LP
.SH "終了ステータス"
.LP
.LP
次の終了値が返されます。
.LP
.LP
\f2\ 0\fP " 成功"
.LP
.LP
\f2>0\fP " エラー"
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
pack200(1)
.TP 2
o
.na
\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
o
.na
\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
jar(1) \- Java Archive ツール」
.TP 2
o
jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
\f2attributes(5)\fP のマニュアルページ
.RE .RE
.PP
.LP \-r \-\-remove\-pack\-file
.SH "注意事項" .RS 4
.LP 入力パック・ファイルを削除します。
.LP .RE
このコマンドと \f2unpack(1) を\fP混同しないでください。これらは別製品です。 .PP
.LP \-v \-\-verbose
.LP .RS 4
SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。 最小限のメッセージが表示されます。このオプションの複数の仕様には、より詳細なメッセージが表示されます。
.LP .RE
.PP
\-q \-\-quiet
.RS 4
メッセージを表示せずに動作するように指定します。
.RE
.PP
\-lfilename \-\-log\-file=\fIfilename\fR
.RS 4
出力メッセージが記録されるログ・ファイルを指定します。
.RE
.PP
\-? \-h \-\-help
.RS 4
\fIunpack200\fRコマンドに関するヘルプ情報を出力します。
.RE
.PP
\-V \-\-version
.RS 4
\fIunpack200\fRコマンドに関するバージョン情報を出力します。
.RE
.PP
\-J\fIoption\fR
.RS 4
Java仮想マシンにoptionを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
.RE
.SH "注意"
.PP
このコマンドと\fIunpack\fRコマンドを混同しないでください。これらは別製品です。
.PP
JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。
.SH "終了ステータス"
.PP
次の終了値が返されます: 正常終了の場合は0、エラーが発生した場合は0より大きい値。
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pack200(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jar(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jarsigner(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Pack200 and Compression」
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment\-guide/pack200\&.html)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
「Java SE Technical Documentation」
(http://docs\&.oracle\&.com/javase/)
.RE
.br
'pl 8.5i
'bp

856
jdk/src/linux/doc/man/ja/wsgen.1
View File

@ -1,656 +1,228 @@
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: wsgen
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java Webサービス・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH wsgen 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.SH "名前" .\" 2 along with this work; if not, write to the Free Software Foundation,
wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.LP .\"
\f3仕様バージョン:\fP 2.1 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.br .\" or visit www.oracle.com if you need additional information or have any
\f3実装バージョン:\fP 2.1.1 .\" questions.
.LP .\"
\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。 .pl 99999
.TH "wsgen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
wsgen \- Webサービスのエンドポイント実装(SEI)クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。
.SH "³µÍ×" .SH "³µÍ×"
.LP .sp
\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイントクラスを読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。JAXWS 2.1.1 RI には wsgen Ant タスクも用意されています。詳細は、 .if n \{\
.na .RS 4
\f2Wsgen Ant タスク\fP @ .\}
.nf
\fIwsgen\fR [ \fIoptions\fR ] \fISEI\fR
.fi .fi
https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlを参照してください。 .if n \{\
.LP
.SH "wsgen の起動"
.RS 3
.TP 2
o
\f3Solaris/Linux\fP
.RS 3
.TP 2
*
\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
.TP 2
*
\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
.RE .RE
.TP 2 .\}
o .PP
\f3Windows\fP \fIoptions\fR
.RS 3 .RS 4
.TP 2 コマンドライン・オプション。オプションを参照してください。
*
\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
.TP 2
*
\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
.RE .RE
.PP
\fISEI\fR
.RS 4
読み取るWebサービスのエンドポイント実装クラス(SEI)です。
.RE .RE
.SH "説明"
.LP .PP
.SH "構文" \fIwsgen\fRコマンドは、JAX\-WS Webサービスで使用されるJAX\-WSポータブル・アーティファクトを生成します。このツールは、Webサービスのエンドポイント・クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。JAXWS 2\&.1\&.1 RIでは\fIwsgen\fR
Antタスクも提供されます。
http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.htmlのJAX\-WS (wsgen)ページのToolsタブを参照してください。
.PP
\fIwsgen\fRコマンドを起動するには、次を行います。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 export JAXWS_HOME=/pathto/jaxws\-ri
.fl $JAXWS_HOME/bin/wsgen\&.sh \-help
wsgen [options] <SEI>\fP
.br
\f3
.fl
\fP
.fi .fi
.LP .if n \{\
次の表に、 \f2wsgen\fP のオプションを示します。 .RE
.br .\}
.LP .SH "オプション"
.TS .PP
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1 \-classpath \fIpath\fR
.de 35 .RS 4
.ps \n(.s 入力クラス・ファイルの場所。
.vs \n(.vu .RE
.in \n(.iu .PP
.if \n(.u .fi \-cp \fIpath\fR
.if \n(.j .ad .RS 4
.if \n(.j=0 .na 入力クラス・ファイルの場所。
.. .RE
.nf .PP
.nr #~ 0 \-d \fIdirectory\fR
.if n .nr #~ 0.6n .RS 4
.ds #d .d 生成された出力ファイルを格納する場所。
.if \(ts\n(.z\(ts\(ts .ds #d nl .RE
.fc .PP
.nr 33 \n(.s \-extension
.rm 80 81 .RS 4
.nr 34 \n(.lu ベンダー拡張を使用可能にします。拡張を使用すると、アプリケーションの移植性が失われたり、他の実装と連携できなくなる可能性があります。
.eo .RE
.am 81 .PP
.br \-help
.di a+ .RS 4
.35 \fIwsgen\fRコマンドに関するヘルプ・メッセージを表示します。
.ft \n(.f .RE
.ll \n(34u*1u/3u .PP
.if \n(.l<\n(81 .ll \n(81u \-keep
.in 0 .RS 4
入力クラスファイルの検索場所を指定します 生成されたファイルを保存します。
.br .RE
.di .PP
.nr a| \n(dn \-r \fIdirectory\fR
.nr a- \n(dl .RS 4
.. このオプションを\fI\-wsdl\fRオプションとともに使用して、WSDLなど生成されたリソース・ファイルを配置する場所を指定します。
.ec \ .RE
.eo .PP
.am 81 \-s \fIdirectory\fR
.br .RS 4
.di b+ 生成されたソース・ファイルを格納する場所。
.35 .RE
.ft \n(.f .PP
.ll \n(34u*1u/3u \-verbose
.if \n(.l<\n(81 .ll \n(81u .RS 4
.in 0 コンパイラ・メッセージを表示します。
\-classpath <path> \f2と同じです\fP .RE
.br .PP
.di \-version
.nr b| \n(dn .RS 4
.nr b- \n(dl リリース情報を出力します。
.. .RE
.ec \ .PP
.eo \-wsdl [ :protocol ]
.am 81 .RS 4
.br エンドポイントをデプロイする前に確認するWSDLファイルを生成するオプション・コマンド。WSDLファイルには、サービスを呼び出す方法、パラメータに必要な値、返されるデータ構造についてのコンピュータで読取り可能な記述が含まれます。
.di c+ .sp
.35 デフォルトでは\fIwsgen\fRコマンドはWSDLファイルを生成しません。\fIprotocol\fR値は省略可能であり、WSDLバインディング(\fIwsdl:binding\fR)で使用するプロトコルを指定するために使用されます。有効なプロトコルは、\fIsoap1\&.1\fRと\fIXsoap1\&.2\fRです。デフォルトは\fIsoap1\&.1\fRです。\fIXsoap1\&.2\fRプロトコルは標準ではないため、\fI\-extension\fRオプションとともにのみ使用可能です。
.ft \n(.f .RE
.ll \n(34u*1u/3u .PP
.if \n(.l<\n(81 .ll \n(81u \-servicename \fIname\fR
.in 0 .RS 4
生成される出力ファイルを格納する場所を指定します \fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLサービス(\fIwsdl:service\fR)名を指定します。例:
.br \fI\-servicename "{http://mynamespace/}MyService"\fR。
.di .RE
.nr c| \n(dn .PP
.nr c- \n(dl \-portname \fIname\fR
.. .RS 4
.ec \ \fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLポート(\fIwsdl:port\fR)名を指定します。例:
.eo \fI\-portname "{http://mynamespace/}MyPort"\fR。
.am 81 .RE
.br
.di d+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
.br
.di
.nr d| \n(dn
.nr d- \n(dl
..
.ec \
.eo
.am 81
.br
.di e+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
ヘルプを表示します
.br
.di
.nr e| \n(dn
.nr e- \n(dl
..
.ec \
.eo
.am 81
.br
.di f+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
生成されたファイルを保持します
.br
.di
.nr f| \n(dn
.nr f- \n(dl
..
.ec \
.eo
.am 81
.br
.di g+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
常に \-wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
.br
.di
.nr g| \n(dn
.nr g- \n(dl
..
.ec \
.eo
.am 81
.br
.di h+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
生成されるソースファイルを格納する場所を指定する
.br
.di
.nr h| \n(dn
.nr h- \n(dl
..
.ec \
.eo
.am 81
.br
.di i+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
コンパイラが実行している処理に関するメッセージを出力します
.br
.di
.nr i| \n(dn
.nr i- \n(dl
..
.ec \
.eo
.am 81
.br
.di j+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
.br
.di
.nr j| \n(dn
.nr j- \n(dl
..
.ec \
.eo
.am 81
.br
.di k+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
デフォルトでは \f2wsgen\fP は WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は \f2wsgen\fP が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。 \f2protocol\fP は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために \f2使用されます\fP。有効なプロトコルは次のとおりです。 \f2soap1.1\fP と \f2Xsoap1.2\fP。デフォルトは \f2soap1.1\fP です。 \f2Xsoap1.2\fP は標準ではないため、 \f2\-extension\fP オプションと組み合わせないと使用できません。
.br
.di
.nr k| \n(dn
.nr k- \n(dl
..
.ec \
.eo
.am 81
.br
.di l+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:service\fP の名前を指定するために使用します。例: \f2\-servicename "{http://mynamespace/}MyService"\fP
.br
.di
.nr l| \n(dn
.nr l- \n(dl
..
.ec \
.eo
.am 81
.br
.di m+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:port\fP の名前を指定するために使用します。例: \f2\-portname "{http://mynamespace/}MyPort"\fP
.br
.br
.di
.nr m| \n(dn
.nr m- \n(dl
..
.ec \
.35
.nf
.ll \n(34u
.nr 80 0
.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-classpath <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-cp <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-d <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-extension\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-help\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-keep\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-r <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-s <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-verbose\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-version\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-wsdl[:protocol]\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-servicename <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-portname <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 81 0
.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
.nr 38 \n(a-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(b-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(c-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(d-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(e-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(f-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(g-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(i-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(j-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(k-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(l-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(m-
.if \n(81<\n(38 .nr 81 \n(38
.35
.nf
.ll \n(34u
.nr 38 1n
.nr 79 0
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 137 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
.eo
.de T#
.ds #d .d
.if \(ts\n(.z\(ts\(ts .ds #d nl
.mk ##
.nr ## -1v
.ls 1
.ls
..
.ec
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.a+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(b|u+\n(.Vu
.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.b+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(c|u+\n(.Vu
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.c+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(d|u+\n(.Vu
.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.d+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(e|u+\n(.Vu
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.e+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.f+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(g|u+\n(.Vu
.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.g+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(h|u+\n(.Vu
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.h+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(i|u+\n(.Vu
.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.i+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(j|u+\n(.Vu
.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.j+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(k|u+\n(.Vu
.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.k+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(l|u+\n(.Vu
.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.l+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(m|u+\n(.Vu
.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.m+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.fc
.nr T. 1
.T# 1
.35
.rm a+
.rm b+
.rm c+
.rm d+
.rm e+
.rm f+
.rm g+
.rm h+
.rm i+
.rm j+
.rm k+
.rm l+
.rm m+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
.LP
.SH "Îã" .SH "Îã"
.PP
次の例では、Stockディレクトリ内に\fI@WebService\fR注釈を持つ\fIStockService\fRのラッパー・クラスを生成します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 wsgen \-d stock \-cp myclasspath stock\&.StockService
.fl
\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
.fl
.fi .fi
.LP .if n \{\
\f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。 .RE
.\}
.PP
次の例では、SOAP 1\&.1 WSDLおよび\fI@WebService\fR注釈を持つ\fIstock\&.StockService\fRクラスのスキーマを生成します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService
.fl
\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
.fl
.fi .fi
.LP .if n \{\
SOAP 1.1 WSDL と、@WebService 注釈が付けられた Java クラス stock.StockService のスキーマが生成されます。 .RE
.\}
.PP
次の例では、SOAP 1\&.2 WSDLを生成します。
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 wsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService
.fl
\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
.fl
.fi .fi
.LP .if n \{\
SOAP 1.2 WSDL が生成されます。 .RE
.LP .\}
サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。 .PP
\fB注意:\fR
サービスのデプロイ時にJAXWS実行時環境でWSDLが生成されるため、開発時にWSDLを生成する必要はありません。
.SH "関連項目"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
wsimport(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.htmlの
JAX\-WS (wsgen)ページのToolsタブを参照してください。
.RE
.br
'pl 8.5i
'bp

1376
jdk/src/linux/doc/man/ja/wsimport.1
View File

File diff suppressed because it is too large Load Diff

620
jdk/src/linux/doc/man/ja/xjc.1
View File

@ -1,298 +1,342 @@
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved. '\" t
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
." .\" Title: xjc
." This code is free software; you can redistribute it and/or modify it .\" Language: English
." under the terms of the GNU General Public License version 2 only, as .\" Date: 2013年11月21日
." published by the Free Software Foundation. .\" SectDesc: Java Webサービス・ツール
." .\" Software: JDK 8
." This code is distributed in the hope that it will be useful, but WITHOUT .\" Arch: 汎用
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\"
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
." version 2 for more details (a copy is included in the LICENSE file that .\"
." accompanied this code). .\" This code is free software; you can redistribute it and/or modify it
." .\" under the terms of the GNU General Public License version 2 only, as
." You should have received a copy of the GNU General Public License version .\" published by the Free Software Foundation.
." 2 along with this work; if not, write to the Free Software Foundation, .\"
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" This code is distributed in the hope that it will be useful, but WITHOUT
." .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." or visit www.oracle.com if you need additional information or have any .\" version 2 for more details (a copy is included in the LICENSE file that
." questions. .\" accompanied this code).
." .\"
.TH xjc 1 "07 May 2011" .\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.LP .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.ad c .\"
.SH "名前" .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
xjc \- XML バインドのための Java(TM) アーキテクチャー .\" or visit www.oracle.com if you need additional information or have any
.br .\" questions.
バインディングコンパイラ .\"
.LP .pl 99999
\f3仕様バージョン:\fP 2.1 .TH "xjc" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール"
.br .\" -----------------------------------------------------------------
\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l .\" * Define some portability stuff
.\" -----------------------------------------------------------------
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.SH "xjc の起動" .\" http://bugs.debian.org/507673
.LP .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.LP .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
バインディングコンパイラを起動するには、使用するプラットフォームに応じた bin ディレクトリ内の \f2xjc\fP シェルスクリプト \f2を\fP 使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。 .ie \n(.g .ds Aq \(aq
.na .el .ds Aq '
\f2xjc を Ant とともに使用する\fP @ .\" -----------------------------------------------------------------
.fi .\" * set default formatting
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。 .\" -----------------------------------------------------------------
.LP .\" disable hyphenation
.LP .nh
\f2% xjc \-help\fP .\" disable justification (adjust text to left margin only)
.LP .ad l
.SS .\" -----------------------------------------------------------------
出力 .\" * MAIN CONTENT STARTS HERE *
.LP .\" -----------------------------------------------------------------
.SH "NAME"
xjc \- XMLスキーマ・ファイルを完全注釈付きのJavaクラスにコンパイルします。
.SH "概要"
.sp
.if n \{\
.RS 4
.\}
.nf .nf
\f3 \fIxjc\fR [ \fIoptions\fR ] \fIschema\fR \fIfile/URL/dir/jar\fR \&.\&.\&. [\fI\-b\fR \fIbindinfo\fR ] \&.\&.\&.
.fl
Usage: xjc [\-options ...] <schema file/URL/dir/jar> ... [\-b <bindinfo>] ...
.fl
If dir is specified, all schema files in it will be compiled.
.fl
If jar is specified, /META\-INF/sun\-jaxb.episode binding file will be compiled.
.fl
Options:
.fl
\-nv : do not perform strict validation of the input schema(s)
.fl
\-extension : allow vendor extensions \- do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec
.fl
\-b <file/dir> : specify external bindings files (each <file> must have its own \-b); if a directory is given, **/*.xjb is searched
.fl
\-d <dir> : generated files will go into this directory
.fl
\-p <pkg> : specifies the target package
.fl
\-httpproxy <proxy> : set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort
.fl
\-httpproxyfile <f> : works like \-httpproxy but takes the argument in a file to protect password
.fl
\-classpath <arg> : specify where to find user class files
.fl
\-catalog <file> : specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format
.fl
\-readOnly : generated files will be in read\-only mode
.fl
\-npa : suppress generation of package level annotations (**/package\-info.java)
.fl
\-no\-header : suppress generation of a file header with timestamp
.fl
\-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features
.fl
\-xmlschema : treat input as W3C XML Schema (default)
.fl
\-relaxng : treat input as RELAX NG (experimental,unsupported)
.fl
\-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported)
.fl
\-dtd : treat input as XML DTD (experimental,unsupported)
.fl
\-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported)
.fl
\-verbose : be extra verbose
.fl
\-quiet : suppress compiler output
.fl
\-help : display this help message
.fl
\-version : display version information
.fl
.fl
.fl
Extensions:
.fl
\-Xlocator : enable source location support for generated code
.fl
\-Xsync\-methods : generate accessor methods with the 'synchronized' keyword
.fl
\-mark\-generated : mark the generated code as @javax.annotation.Generated
.fl
\-episode <FILE> : generate the episode file for separate compilation
.fl
\fP
.fi .fi
.if n \{\
.LP .RE
.\}
.PP
\fIoptions\fR
.RS 4
コマンドライン・オプション。オプションを参照してください。
.RE
.PP
schema \fIfile/URL/dir/jar \&.\&.\&.\fR
.RS 4
XMLスキーマ・ファイルの場所。\fIdir\fRが指定されている場合は、すべてのスキーマ・ファイルがコンパイルされます。\fIjar\fRが指定されている場合は、\fI/META\-INF/sun\-jaxb\&.episode\fRバインディング・ファイルがコンパイルされます。
.RE
.PP
\-b \fIbindinfo\fR
.RS 4
バインディング・ファイルの場所。
.RE
.SH "説明"
.PP
プラットフォームのbinディレクトリにある適切な\fIxjc\fRシェル・スクリプトを使用して、バインディング・コンパイラを起動します。バインディング・コンパイラを実行するAntタスクもあります。http://jaxb\&.java\&.net/nonav/2\&.1\&.3/docs/xjcTask\&.htmlの
Using the XJC with Antを参照してください
.SH "オプション" .SH "オプション"
.LP .sp
.RS 3 .RS 4
.TP 3 .ie n \{\
\-nv \h'-04'\(bu\h'+03'\c
デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。 .\}
.TP 3 .el \{\
\-extension .sp -1
デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。 .IP \(bu 2.3
.TP 3 .\}
\-b <file> 非標準オプションも参照してください
処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに \f2「\-b」\fP スイッチを指定する必要があります。) 外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる 1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。 \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
.br
\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
.TP 3
\-d <dir>
デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
.TP 3
\-p <pkg>
このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
.TP 3
\-httpproxy <proxy>
HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、 \f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティーを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
.TP 3
\-httpproxyfile <file>
HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
.TP 3
\-classpath <arg>
<jxb:javaType> および <xjc:superClass> \f2カスタマイズが使用する\fP クライアントアプリケーションの \f2クラスファイルの検索場所を\fP 指定します。
.TP 3
\-catalog <file>
外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、 \f2カタログリゾルバの\fP サンプルアプリケーションを調べてください。
.TP 3
\-readOnly
デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
.TP 3
\-npa
パッケージレベルの注釈を **/package\-info.java に生成することを抑制します。このスイッチを使用して生成するコードでは、これらの注釈がほかの生成済みクラスに内部化されます。
.TP 3
\-no\-header
多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。
.TP 3
\-target 2.0
なんらかの JAXB 2.1 機能に依存するコードを生成しないようにします。これにより、生成されたコードを JAXB 2.0 ランタイム (JavaSE 6 など) で実行できます。
.TP 3
\-xmlschema
入力スキーマを W3C XML スキーマ (デフォルト) と見なします。このスイッチを指定しなくても、入力スキーマは W3C XML スキーマと見なされます。
.TP 3
\-relaxng
入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-relaxng\-compact
入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-dtd
入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-wsdl
入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
.TP 3
\-quiet
進捗情報や警告など、コンパイラの出力を抑制します。
.TP 3
\-verbose
情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
.TP 3
\-help
コンパイラスイッチの概要を表示します。
.TP 3
\-version
コンパイラのバージョン情報を表示します。
.TP 3
<schema file/URL/dir>
コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
.RE .RE
.sp
.LP .RS 4
.SS .ie n \{\
非標準のコマンド行オプション \h'-04'\(bu\h'+03'\c
.LP .\}
.RS 3 .el \{\
.TP 3 .sp -1
\-Xlocator .IP \(bu 2.3
生成されたコードでは、非整列化のあとに Java Bean インスタンスに含まれるソース XML に関する SAX Locator 情報が公開されます。 .\}
.TP 3 非推奨で削除されたオプションも参照してください
\-Xsync\-methods
生成されたすべてのメソッドシグニチャーに \f2同期された\fP キーワードが含められます。
.TP 3
\-mark\-generated
生成されたコードに注釈 \f2@javax.annotation.Generated\fP を付けます。
.TP 3
\-episode <file>
コンパイルごとに指定されたエピソードファイルを生成します。
.RE .RE
.PP
.LP \-nv
.SS .RS 4
非推奨コマンド行オプションおよび削除されたコマンド行オプション デフォルトでは、XJCバインディング・コンパイラは、ソース・スキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証か無効になります。これは、バインディング・コンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
.LP
.RS 3
.TP 3
\-host & \-port
これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
.TP 3
\-use\-runtime
JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
.TP 3
\-source
\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。このスイッチは、JAXB 2.0 の今後のリリースから削除されることになりました。1.0.x コードを生成する必要がある場合は、1.0.x コードベースのインストールを使用してください。
.RE .RE
.PP
.LP \-extension
.SS .RS 4
コンパイラの制限 デフォルトでは、XJCバインディング・コンパイラは、JAXB仕様のCompatibilityの章で説明されているルールを厳密に強制します。付録E\&.2には、JAXB v1\&.0で完全にはサポートされていない一連のW3C XMLスキーマ機能が定義されています。場合によっては、このスイッチで有効になる\fI\-extension\fRモードでそれらの機能が使用できる場合があります。また、デフォルトの厳密なモードでは、仕様に定義されているバインディング・カスタマイズのみが使用できます。\fI\-extension\fRスイッチを指定すれば、JAXB Vendor Extensionを使用できます。
.LP
.LP
通常は、関連するすべてのスキーマを、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
.LP
.LP
xjc を実行するときは、次に示す制限に注意してください。これらの制限のほとんどは、xjc を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
.LP
.RS 3
.TP 2
o
複数のスキーマを同時にコンパイルする場合は、ターゲットの Java パッケージ名に次の優先順位の規則が適用されることに注意してください。
.RS 3
.TP 3
1.
「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
.TP 3
2.
<\f2jaxb:package\fP> のカスタマイズ
.TP 3
3.
\f2targetNamespace\fP が宣言されている場合は、 \f2仕様に定義されている targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
.TP 3
4.
\f2targetNamespace\fP が宣言されていない場合は、「generated」という名前のハードコードされたパッケージを使用します。
.RE .RE
.TP 2 .PP
o \-b \fIfile\fR
名前空間ごとに複数の <\f2jaxb:schemaBindings\fP> を持つことは不正です。このため、1 つのターゲット名前空間内の 2 つのスキーマを異なる Java パッケージにコンパイルすることはできません。 .RS 4
.TP 2 処理する外部バインディング・ファイルを1つまたは複数指定します。バインディング・ファイルごとに\fI\-b\fRスイッチを指定する必要があります。外部バインディング・ファイルの構文は柔軟です。複数のスキーマのカスタマイズが含まれる1つのバインディング・ファイルを使用したり、それらのカスタマイズを複数のバインディング・ファイルに分割したりできます。次に例を示します。\fIxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings123\&.xjb\fR
o \fIxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings1\&.xjb \-b bindings2\&.xjb \-b bindings3\&.xjb\fRまた、コマンドラインにスキーマ・ファイルとバインディング・ファイルを指定する順番は任意です。
1 つの Java パッケージにコンパイルされるすべてのスキーマは、XJC バインディングコンパイラに同時に送信する必要があります。個別にコンパイルすることはできず、予期したとおりに動作しません。
.TP 2
o
複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
.RE .RE
.PP
.LP \-d \fIdir\fR
.RS 4
デフォルトでは、XJCバインディング・コンパイラは、Javaコンテンツ・クラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはすでに存在している必要があります。XJCバインディング・コンパイラでは作成されません。
.RE
.PP
\-p \fIpkg\fR
.RS 4
このコマンドライン・オプションでターゲット・パッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディング・カスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
.RE
.PP
\-httpproxy \fIproxy\fR
.RS 4
\fI[user[:password]@]proxyHost[:proxyPort]\fR形式でHTTPまたはHTTPSプロキシを指定します。古い\fI\-host\fRおよび\fI\-port\fRオプションは、下位互換性のために引き続きRIでサポートされますが、非推奨となりました。このオプションで指定されたパスワードは、topコマンドを使用する他のユーザーが表示できる引数です。セキュリティを高めるには、\fI\-httpproxyfile\fRを使用してください。
.RE
.PP
\-httpproxyfile file
.RS 4
ファイルを使用して、HTTPまたはHTTPSプロキシを指定します。形式は\fI\-httpproxy\fRオプションと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。
.RE
.PP
\-classpath arg
.RS 4
\fIjxb:javaType\fRおよびxjc:\fIsuperClass\fRカスタマイズが使用するクライアント・アプリケーションのクラス・ファイルの検索場所を指定します。
.RE
.PP
\-catalog file
.RS 4
外部エンティティ参照を解決するカタログ・ファイルを指定します。TR9401、XCatalogおよびOASIS XML Catalogの各形式がサポートされます。http://xerces\&.apache\&.org/xml\-commons/components/resolver/resolver\-article\&.htmlの
XML Entity and URI Resolversを参照してください
.RE
.PP
\-readOnly
.RS 4
デフォルトでは、XJCバインディング・コンパイラは、生成するJavaソース・ファイルを書込みから保護しません。このオプションを使用すると、XJCバインディング・コンパイラは生成されるJavaソースを強制的に読取り専用にします。
.RE
.PP
\-npa
.RS 4
\fI**/package\-info\&.java\fRへのパッケージ・レベルの注釈の生成を抑制します。このスイッチを使用して生成するコードでは、これらの注釈が他の生成済クラスに内部化されます。
.RE
.PP
\-no\-header
.RS 4
多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードと\fIdiff\fRコマンドとの互換性がより強くなります。
.RE
.PP
\-target 2\&.0
.RS 4
JAXB 2\&.1機能に依存するコードを生成しないようにします。これにより、生成されたコードをJAXB 2\&.0ランタイム環境(Java SE 6など)で実行できるようになります。
.RE
.PP
\-xmlschema
.RS 4
入力スキーマをW3C XMLスキーマとして扱います(デフォルト)。このスイッチを指定しない場合、入力スキーマはW3C XMLスキーマと同じように扱われます。
.RE
.PP
\-relaxing
.RS 4
入力スキーマをRELAX NGとして扱います(試験的および未サポート)。RELAX NGスキーマのサポートはJAXB Vendor Extensionとして提供されています。
.RE
.PP
\-relaxing\-compact
.RS 4
入力スキーマをRELAX NG圧縮構文として処理します(試験的および未サポート)。RELAX NGスキーマのサポートはJAXB Vendor Extensionとして提供されています。
.RE
.PP
\-dtd
.RS 4
入力スキーマをXML DTDとして扱います(試験的および未サポート)。RELAX NGスキーマのサポートはJAXB Vendor Extensionとして提供されています。
.RE
.PP
\-wsdl
.RS 4
入力をWSDLとして扱い、その内部のスキーマをコンパイルします(試験的および未サポート)。
.RE
.PP
\-quiet
.RS 4
進捗情報や警告など、コンパイラの出力を抑制します。
.RE
.PP
\-verbose
.RS 4
情報メッセージを出力したり特定のエラー発生時にスタック・トレースを表示したりするなど、きわめて冗長になります。
.RE
.PP
\-help
.RS 4
コンパイラ・スイッチのサマリーを表示します。
.RE
.PP
\-version
.RS 4
コンパイラのバージョン情報を表示します。
.RE
.PP
\fIschema file/URL/dir\fR
.RS 4
コンパイル対象となる1つまたは複数のスキーマ・ファイルを指定します。ディレクトリを指定する場合、\fIxjc\fRコマンドはすべてのスキーマ・ファイルをスキャンしてコンパイルします。
.RE
.SS "非標準オプション"
.PP
\-XLocator
.RS 4
生成されたコードでは、非整列化の後にJava Beanインスタンスに含まれるソースXMLに関するSAX Locator情報が公開されます。
.RE
.PP
\-Xsync\-methods
.RS 4
生成されたすべてのメソッド・シグニチャに\fIsynchronized\fRキーワードが含められます。
.RE
.PP
\-mark\-generated
.RS 4
生成されたコードに注釈\fI@javax\&.annotation\&.Generated\fRを付けます。
.RE
.PP
\-episode file
.RS 4
コンパイルごとに指定されたエピソード・ファイルを生成します。
.RE
.SS "非推奨で削除されたオプション"
.PP
\-host & \-port
.RS 4
これらのオプションは\fI\-httpproxy\fRオプションで置き換えられました。これらのオプションは、下位互換性を確保するためにサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
.RE
.PP
\-use\-runtime
.RS 4
JAXB 2\&.0仕様では、移植性のあるランタイム環境が定義されたため、JAXB RIが\fI**/impl/runtime \fRパッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
.RE
.PP
\-source
.RS 4
\fI\-source\fR互換性スイッチは、JAXB 2\&.0の最初のEarly Access版で導入されました。このスイッチはJAXB 2\&.0の今後のリリースから削除されます。1\&.0\&.xコードを生成する必要がある場合は、1\&.0\&.xコード・ベースのインストールを使用してください。
.RE
.SH "コンパイラの制限"
.PP
通常は、関連するすべてのスキーマを、同じバインディング・コンパイラ・スイッチを指定して1つの単位としてコンパイルするのが最も安全です。\fIxjc\fRコマンドの実行時には、次の制限リストに留意してください。これらの問題のほとんどは、\fIxjc\fRコマンドを何度か呼び出して複数のスキーマをコンパイルする場合にのみ当てはまります。
.PP
複数のスキーマを同時にコンパイルする場合は、ターゲットのJavaパッケージ名に次の優先順位のルールが適用されることに注意してください。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
\fI\-p\fRオプションが最も優先されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
\fIjaxb:package\fRのカスタマイズ。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
\fItargetNamespace\fRが宣言されている場合は、\fIt\fR\fIargetNamespace\fRを仕様で定義されているJavaパッケージ名のアルゴリズムに適用します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
\fItargetNamespace\fRが宣言されていない場合は、\fIgenerated\fRという名前のハードコードされたパッケージを使用します。
.RE
.PP
1つのネームスペースが複数の\fIjaxb:schemaBindings\fRを持つことはできないため、異なるJavaパッケージにコンパイラされる同一ターゲット・ネームスペースが2つのスキーマを持つことはできません。
.PP
同じJavaパッケージにコンパイラされるスキーマはすべて、同時にXJCバインディング・コンパイラに送信される必要があります。別々にコンパイルすると、予想どおりに機能しません。
.PP
複数のスキーマ・ファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
.SH "関連項目" .SH "関連項目"
.LP .sp
.RS 3 .RS 4
.TP 2 .ie n \{\
o \h'-04'\(bu\h'+03'\c
コマンド行でのコンバータの実行 (XJC): [ .\}
.na .el \{\
\f2コマンド行の命令\fP @ .sp -1
.fi .IP \(bu 2.3
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html、 .\}
.na http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/xjc\&.htmlの
\f2xjc を Ant とともに使用する\fP @ Binding Compiler (xjc)
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
.TP 2
o
.na
\f2XML バインドのための Java アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE .RE
.sp
.LP .RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
http://www\&.oracle\&.com/technetwork/articles/javase/index\-140168\&.htmlの
Java Architecture for XML Binding (JAXB)
.RE
.br
'pl 8.5i
'bp

3
jdk/src/macosx/classes/apple/laf/AquaLookAndFeel.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -30,4 +30,5 @@ package apple.laf;
* "apple.laf.AquaLookAndFeel" is so widely used, documented, * "apple.laf.AquaLookAndFeel" is so widely used, documented,
* and hard coded that it is impractical to remove it. * and hard coded that it is impractical to remove it.
*/ */
@SuppressWarnings("serial") // JDK implementation class
public class AquaLookAndFeel extends com.apple.laf.AquaLookAndFeel { } public class AquaLookAndFeel extends com.apple.laf.AquaLookAndFeel { }

2
jdk/src/macosx/classes/apple/security/AppleProvider.java
View File

@ -36,7 +36,7 @@ import java.security.*;
* *
* This provider only exists to provide access to the Apple keychain-based KeyStore implementation * This provider only exists to provide access to the Apple keychain-based KeyStore implementation
*/ */
@SuppressWarnings("serial") // JDK implementation class
public final class AppleProvider extends Provider { public final class AppleProvider extends Provider {
private static final String info = "Apple Provider"; private static final String info = "Apple Provider";

17
jdk/src/macosx/classes/com/apple/eawt/AppEvent.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,6 +36,7 @@ import java.awt.Window;
* @since Java for Mac OS X 10.6 Update 3 * @since Java for Mac OS X 10.6 Update 3
* @since Java for Mac OS X 10.5 Update 8 * @since Java for Mac OS X 10.5 Update 8
*/ */
@SuppressWarnings("serial") // JDK implementation class
public abstract class AppEvent extends EventObject { public abstract class AppEvent extends EventObject {
AppEvent() { AppEvent() {
super(Application.getApplication()); super(Application.getApplication());
@ -44,6 +45,7 @@ public abstract class AppEvent extends EventObject {
/** /**
* Contains a list of files. * Contains a list of files.
*/ */
@SuppressWarnings("serial") // JDK implementation class
public abstract static class FilesEvent extends AppEvent { public abstract static class FilesEvent extends AppEvent {
final List<File> files; final List<File> files;
@ -64,6 +66,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see OpenFilesHandler#openFiles(OpenFilesEvent) * @see OpenFilesHandler#openFiles(OpenFilesEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class OpenFilesEvent extends FilesEvent { public static class OpenFilesEvent extends FilesEvent {
final String searchTerm; final String searchTerm;
@ -87,6 +90,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see PrintFilesHandler#printFiles(PrintFilesEvent) * @see PrintFilesHandler#printFiles(PrintFilesEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class PrintFilesEvent extends FilesEvent { public static class PrintFilesEvent extends FilesEvent {
PrintFilesEvent(final List<File> files) { PrintFilesEvent(final List<File> files) {
super(files); super(files);
@ -98,6 +102,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see OpenURIHandler#openURI(OpenURIEvent) * @see OpenURIHandler#openURI(OpenURIEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class OpenURIEvent extends AppEvent { public static class OpenURIEvent extends AppEvent {
final URI uri; final URI uri;
@ -118,6 +123,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see AboutHandler#handleAbout() * @see AboutHandler#handleAbout()
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class AboutEvent extends AppEvent { AboutEvent() { } } public static class AboutEvent extends AppEvent { AboutEvent() { } }
/** /**
@ -125,6 +131,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see PreferencesHandler#handlePreferences() * @see PreferencesHandler#handlePreferences()
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class PreferencesEvent extends AppEvent { PreferencesEvent() { } } public static class PreferencesEvent extends AppEvent { PreferencesEvent() { } }
/** /**
@ -132,6 +139,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see QuitHandler#handleQuitRequestWith(QuitEvent, QuitResponse) * @see QuitHandler#handleQuitRequestWith(QuitEvent, QuitResponse)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class QuitEvent extends AppEvent { QuitEvent() { } } public static class QuitEvent extends AppEvent { QuitEvent() { } }
/** /**
@ -139,6 +147,7 @@ public abstract class AppEvent extends EventObject {
* *
* @see AppReOpenedListener#appReOpened(AppReOpenedEvent) * @see AppReOpenedListener#appReOpened(AppReOpenedEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class AppReOpenedEvent extends AppEvent { AppReOpenedEvent() { } } public static class AppReOpenedEvent extends AppEvent { AppReOpenedEvent() { } }
/** /**
@ -147,6 +156,7 @@ public abstract class AppEvent extends EventObject {
* @see AppForegroundListener#appRaisedToForeground(AppForegroundEvent) * @see AppForegroundListener#appRaisedToForeground(AppForegroundEvent)
* @see AppForegroundListener#appMovedToBackground(AppForegroundEvent) * @see AppForegroundListener#appMovedToBackground(AppForegroundEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class AppForegroundEvent extends AppEvent { AppForegroundEvent() { } } public static class AppForegroundEvent extends AppEvent { AppForegroundEvent() { } }
/** /**
@ -155,6 +165,7 @@ public abstract class AppEvent extends EventObject {
* @see AppHiddenListener#appHidden(AppHiddenEvent) * @see AppHiddenListener#appHidden(AppHiddenEvent)
* @see AppHiddenListener#appUnhidden(AppHiddenEvent) * @see AppHiddenListener#appUnhidden(AppHiddenEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class AppHiddenEvent extends AppEvent { AppHiddenEvent() { } } public static class AppHiddenEvent extends AppEvent { AppHiddenEvent() { } }
/** /**
@ -163,6 +174,7 @@ public abstract class AppEvent extends EventObject {
* @see UserSessionListener#userSessionActivated(UserSessionEvent) * @see UserSessionListener#userSessionActivated(UserSessionEvent)
* @see UserSessionListener#userSessionDeactivated(UserSessionEvent) * @see UserSessionListener#userSessionDeactivated(UserSessionEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class UserSessionEvent extends AppEvent { UserSessionEvent() { } } public static class UserSessionEvent extends AppEvent { UserSessionEvent() { } }
/** /**
@ -171,6 +183,7 @@ public abstract class AppEvent extends EventObject {
* @see ScreenSleepListener#screenAboutToSleep(ScreenSleepEvent) * @see ScreenSleepListener#screenAboutToSleep(ScreenSleepEvent)
* @see ScreenSleepListener#screenAwoke(ScreenSleepEvent) * @see ScreenSleepListener#screenAwoke(ScreenSleepEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class ScreenSleepEvent extends AppEvent { ScreenSleepEvent() { } } public static class ScreenSleepEvent extends AppEvent { ScreenSleepEvent() { } }
/** /**
@ -179,6 +192,7 @@ public abstract class AppEvent extends EventObject {
* @see SystemSleepListener#systemAboutToSleep(SystemSleepEvent) * @see SystemSleepListener#systemAboutToSleep(SystemSleepEvent)
* @see SystemSleepListener#systemAwoke(SystemSleepEvent) * @see SystemSleepListener#systemAwoke(SystemSleepEvent)
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class SystemSleepEvent extends AppEvent { SystemSleepEvent() { } } public static class SystemSleepEvent extends AppEvent { SystemSleepEvent() { } }
/** /**
@ -188,6 +202,7 @@ public abstract class AppEvent extends EventObject {
* *
* @since Java for Mac OS X 10.7 Update 1 * @since Java for Mac OS X 10.7 Update 1
*/ */
@SuppressWarnings("serial") // JDK implementation class
public static class FullScreenEvent extends AppEvent { public static class FullScreenEvent extends AppEvent {
final Window window; final Window window;

3
jdk/src/macosx/classes/com/apple/eawt/ApplicationEvent.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -34,6 +34,7 @@ import java.util.EventObject;
* @since 1.4 * @since 1.4
*/ */
@Deprecated @Deprecated
@SuppressWarnings("serial") // JDK implementation class
public class ApplicationEvent extends EventObject { public class ApplicationEvent extends EventObject {
private String fFilename = null; private String fFilename = null;
private boolean fHandled = false; private boolean fHandled = false;

3
jdk/src/macosx/classes/com/apple/laf/AquaCaret.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -35,6 +35,7 @@ import javax.swing.border.Border;
import javax.swing.plaf.UIResource; import javax.swing.plaf.UIResource;
import javax.swing.text.*; import javax.swing.text.*;
@SuppressWarnings("serial") // Superclass is not serializable across versions
public class AquaCaret extends DefaultCaret implements UIResource, PropertyChangeListener { public class AquaCaret extends DefaultCaret implements UIResource, PropertyChangeListener {
final boolean isMultiLineEditor; final boolean isMultiLineEditor;
final JTextComponent c; final JTextComponent c;

4
jdk/src/macosx/classes/com/apple/laf/AquaComboBoxButton.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -33,6 +33,7 @@ import javax.swing.plaf.UIResource;
import apple.laf.JRSUIState; import apple.laf.JRSUIState;
import apple.laf.JRSUIConstants.*; import apple.laf.JRSUIConstants.*;
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaComboBoxButton extends JButton { class AquaComboBoxButton extends JButton {
final protected JComboBox comboBox; final protected JComboBox comboBox;
final protected JList list; final protected JList list;
@ -43,6 +44,7 @@ class AquaComboBoxButton extends JButton {
boolean isPopDown; boolean isPopDown;
boolean isSquare; boolean isSquare;
@SuppressWarnings("serial") // anonymous class
protected AquaComboBoxButton(final AquaComboBoxUI ui, final JComboBox comboBox, final CellRendererPane rendererPane, final JList list) { protected AquaComboBoxButton(final AquaComboBoxUI ui, final JComboBox comboBox, final CellRendererPane rendererPane, final JList list) {
super(""); super("");
putClientProperty("JButton.buttonType", "comboboxInternal"); putClientProperty("JButton.buttonType", "comboboxInternal");

4
jdk/src/macosx/classes/com/apple/laf/AquaComboBoxPopup.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -33,6 +33,7 @@ import javax.swing.plaf.basic.BasicComboPopup;
import sun.lwawt.macosx.CPlatformWindow; import sun.lwawt.macosx.CPlatformWindow;
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaComboBoxPopup extends BasicComboPopup { class AquaComboBoxPopup extends BasicComboPopup {
static final int FOCUS_RING_PAD_LEFT = 6; static final int FOCUS_RING_PAD_LEFT = 6;
static final int FOCUS_RING_PAD_RIGHT = 6; static final int FOCUS_RING_PAD_RIGHT = 6;
@ -147,6 +148,7 @@ class AquaComboBoxPopup extends BasicComboPopup {
} }
@Override @Override
@SuppressWarnings("serial") // anonymous class
protected JList createList() { protected JList createList() {
return new JList(comboBox.getModel()) { return new JList(comboBox.getModel()) {
@Override @Override

3
jdk/src/macosx/classes/com/apple/laf/AquaComboBoxRenderer.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -28,6 +28,7 @@ package com.apple.laf;
import javax.swing.*; import javax.swing.*;
import javax.swing.plaf.UIResource; import javax.swing.plaf.UIResource;
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaComboBoxRenderer extends AquaComboBoxRendererInternal implements UIResource { class AquaComboBoxRenderer extends AquaComboBoxRendererInternal implements UIResource {
public AquaComboBoxRenderer(final JComboBox comboBox) { public AquaComboBoxRenderer(final JComboBox comboBox) {
super(comboBox); super(comboBox);

3
jdk/src/macosx/classes/com/apple/laf/AquaComboBoxRendererInternal.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -30,6 +30,7 @@ import sun.swing.SwingUtilities2;
import javax.swing.*; import javax.swing.*;
import java.awt.*; import java.awt.*;
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaComboBoxRendererInternal extends JLabel implements ListCellRenderer { class AquaComboBoxRendererInternal extends JLabel implements ListCellRenderer {
final JComboBox fComboBox; final JComboBox fComboBox;
boolean fSelected; boolean fSelected;

14
jdk/src/macosx/classes/com/apple/laf/AquaComboBoxUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -202,7 +202,9 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaCustomComboTextField extends JTextField { class AquaCustomComboTextField extends JTextField {
@SuppressWarnings("serial") // anonymous class
public AquaCustomComboTextField() { public AquaCustomComboTextField() {
final InputMap inputMap = getInputMap(); final InputMap inputMap = getInputMap();
inputMap.put(KeyStroke.getKeyStroke("DOWN"), highlightNextAction); inputMap.put(KeyStroke.getKeyStroke("DOWN"), highlightNextAction);
@ -286,6 +288,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
SwingUtilities.replaceUIActionMap(comboBox, actionMap); SwingUtilities.replaceUIActionMap(comboBox, actionMap);
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private abstract class ComboBoxAction extends AbstractAction { private abstract class ComboBoxAction extends AbstractAction {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
if (!comboBox.isEnabled() || !comboBox.isShowing()) { if (!comboBox.isEnabled() || !comboBox.isShowing()) {
@ -306,6 +309,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
/** /**
* Hilight _but do not select_ the next item in the list. * Hilight _but do not select_ the next item in the list.
*/ */
@SuppressWarnings("serial") // anonymous class
private Action highlightNextAction = new ComboBoxAction() { private Action highlightNextAction = new ComboBoxAction() {
@Override @Override
public void performComboBoxAction(AquaComboBoxUI ui) { public void performComboBoxAction(AquaComboBoxUI ui) {
@ -322,6 +326,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
/** /**
* Hilight _but do not select_ the previous item in the list. * Hilight _but do not select_ the previous item in the list.
*/ */
@SuppressWarnings("serial") // anonymous class
private Action highlightPreviousAction = new ComboBoxAction() { private Action highlightPreviousAction = new ComboBoxAction() {
@Override @Override
void performComboBoxAction(final AquaComboBoxUI ui) { void performComboBoxAction(final AquaComboBoxUI ui) {
@ -334,6 +339,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
} }
}; };
@SuppressWarnings("serial") // anonymous class
private Action highlightFirstAction = new ComboBoxAction() { private Action highlightFirstAction = new ComboBoxAction() {
@Override @Override
void performComboBoxAction(final AquaComboBoxUI ui) { void performComboBoxAction(final AquaComboBoxUI ui) {
@ -342,6 +348,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
} }
}; };
@SuppressWarnings("serial") // anonymous class
private Action highlightLastAction = new ComboBoxAction() { private Action highlightLastAction = new ComboBoxAction() {
@Override @Override
void performComboBoxAction(final AquaComboBoxUI ui) { void performComboBoxAction(final AquaComboBoxUI ui) {
@ -351,6 +358,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
} }
}; };
@SuppressWarnings("serial") // anonymous class
private Action highlightPageUpAction = new ComboBoxAction() { private Action highlightPageUpAction = new ComboBoxAction() {
@Override @Override
void performComboBoxAction(final AquaComboBoxUI ui) { void performComboBoxAction(final AquaComboBoxUI ui) {
@ -371,6 +379,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
} }
}; };
@SuppressWarnings("serial") // anonymous class
private Action highlightPageDownAction = new ComboBoxAction() { private Action highlightPageDownAction = new ComboBoxAction() {
@Override @Override
void performComboBoxAction(final AquaComboBoxUI ui) { void performComboBoxAction(final AquaComboBoxUI ui) {
@ -486,12 +495,14 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
// This is somewhat messy. The difference here from BasicComboBoxUI.EnterAction is that // This is somewhat messy. The difference here from BasicComboBoxUI.EnterAction is that
// arrow up or down does not automatically select the // arrow up or down does not automatically select the
@SuppressWarnings("serial") // anonymous class
private static final Action triggerSelectionAction = new AbstractAction() { private static final Action triggerSelectionAction = new AbstractAction() {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
triggerSelectionEvent((JComboBox)e.getSource(), e); triggerSelectionEvent((JComboBox)e.getSource(), e);
} }
}; };
@SuppressWarnings("serial") // anonymous class
private static final Action toggleSelectionAction = new AbstractAction() { private static final Action toggleSelectionAction = new AbstractAction() {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
final JComboBox comboBox = (JComboBox)e.getSource(); final JComboBox comboBox = (JComboBox)e.getSource();
@ -510,6 +521,7 @@ public class AquaComboBoxUI extends BasicComboBoxUI implements Sizeable {
} }
}; };
@SuppressWarnings("serial") // anonymous class
private static Action hideAction = new AbstractAction() { private static Action hideAction = new AbstractAction() {
@Override @Override
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {

23
jdk/src/macosx/classes/com/apple/laf/AquaFileChooserUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -857,6 +857,7 @@ public class AquaFileChooserUI extends FileChooserUI {
// Action to attach to the file list so we can override the default action // Action to attach to the file list so we can override the default action
// of the table for the return key, which is to select the next line. // of the table for the return key, which is to select the next line.
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class DefaultButtonAction extends AbstractAction { protected class DefaultButtonAction extends AbstractAction {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
final JRootPane root = AquaFileChooserUI.this.getFileChooser().getRootPane(); final JRootPane root = AquaFileChooserUI.this.getFileChooser().getRootPane();
@ -883,6 +884,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Creates a new folder. * Creates a new folder.
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class NewFolderAction extends AbstractAction { protected class NewFolderAction extends AbstractAction {
protected NewFolderAction() { protected NewFolderAction() {
super(newFolderAccessibleName); super(newFolderAccessibleName);
@ -944,6 +946,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Responds to an Open, Save, or Choose request * Responds to an Open, Save, or Choose request
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class ApproveSelectionAction extends AbstractAction { protected class ApproveSelectionAction extends AbstractAction {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
fSubPanel.approveSelection(getFileChooser()); fSubPanel.approveSelection(getFileChooser());
@ -953,6 +956,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Responds to an OpenDirectory request * Responds to an OpenDirectory request
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class OpenSelectionAction extends AbstractAction { protected class OpenSelectionAction extends AbstractAction {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
final int index = fFileList.getSelectedRow(); final int index = fFileList.getSelectedRow();
@ -966,6 +970,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Responds to a cancel request. * Responds to a cancel request.
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class CancelSelectionAction extends AbstractAction { protected class CancelSelectionAction extends AbstractAction {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
getFileChooser().cancelSelection(); getFileChooser().cancelSelection();
@ -979,6 +984,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Rescans the files in the current directory * Rescans the files in the current directory
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class UpdateAction extends AbstractAction { protected class UpdateAction extends AbstractAction {
public void actionPerformed(final ActionEvent e) { public void actionPerformed(final ActionEvent e) {
final JFileChooser fc = getFileChooser(); final JFileChooser fc = getFileChooser();
@ -1004,6 +1010,7 @@ public class AquaFileChooserUI extends FileChooserUI {
} }
// Penultimate superclass is JLabel // Penultimate superclass is JLabel
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class MacFCTableCellRenderer extends DefaultTableCellRenderer { protected class MacFCTableCellRenderer extends DefaultTableCellRenderer {
boolean fIsSelected = false; boolean fIsSelected = false;
@ -1084,6 +1091,7 @@ public class AquaFileChooserUI extends FileChooserUI {
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class FileRenderer extends MacFCTableCellRenderer { protected class FileRenderer extends MacFCTableCellRenderer {
public FileRenderer(final Font f) { public FileRenderer(final Font f) {
super(f); super(f);
@ -1100,6 +1108,7 @@ public class AquaFileChooserUI extends FileChooserUI {
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class DateRenderer extends MacFCTableCellRenderer { protected class DateRenderer extends MacFCTableCellRenderer {
public DateRenderer(final Font f) { public DateRenderer(final Font f) {
super(f); super(f);
@ -1134,6 +1143,7 @@ public class AquaFileChooserUI extends FileChooserUI {
return new Dimension(Integer.MAX_VALUE, Integer.MAX_VALUE); return new Dimension(Integer.MAX_VALUE, Integer.MAX_VALUE);
} }
@SuppressWarnings("serial") // anonymous class
protected ListCellRenderer createDirectoryComboBoxRenderer(final JFileChooser fc) { protected ListCellRenderer createDirectoryComboBoxRenderer(final JFileChooser fc) {
return new AquaComboBoxRendererInternal(directoryComboBox) { return new AquaComboBoxRendererInternal(directoryComboBox) {
public Component getListCellRendererComponent(final JList list, final Object value, final int index, final boolean isSelected, final boolean cellHasFocus) { public Component getListCellRendererComponent(final JList list, final Object value, final int index, final boolean isSelected, final boolean cellHasFocus) {
@ -1162,6 +1172,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Data model for a type-face selection combo-box. * Data model for a type-face selection combo-box.
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class DirectoryComboBoxModel extends AbstractListModel implements ComboBoxModel { protected class DirectoryComboBoxModel extends AbstractListModel implements ComboBoxModel {
Vector<File> fDirectories = new Vector<File>(); Vector<File> fDirectories = new Vector<File>();
int topIndex = -1; int topIndex = -1;
@ -1245,6 +1256,7 @@ public class AquaFileChooserUI extends FileChooserUI {
// //
// Renderer for Types ComboBox // Renderer for Types ComboBox
// //
@SuppressWarnings("serial") // anonymous class
protected ListCellRenderer createFilterComboBoxRenderer() { protected ListCellRenderer createFilterComboBoxRenderer() {
return new AquaComboBoxRendererInternal(filterComboBox) { return new AquaComboBoxRendererInternal(filterComboBox) {
public Component getListCellRendererComponent(final JList list, final Object value, final int index, final boolean isSelected, final boolean cellHasFocus) { public Component getListCellRendererComponent(final JList list, final Object value, final int index, final boolean isSelected, final boolean cellHasFocus) {
@ -1266,6 +1278,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Data model for a type-face selection combo-box. * Data model for a type-face selection combo-box.
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class FilterComboBoxModel extends AbstractListModel<FileFilter> implements ComboBoxModel<FileFilter>, protected class FilterComboBoxModel extends AbstractListModel<FileFilter> implements ComboBoxModel<FileFilter>,
PropertyChangeListener { PropertyChangeListener {
protected FileFilter[] filters; protected FileFilter[] filters;
@ -1336,6 +1349,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Acts when FilterComboBox has changed the selected item. * Acts when FilterComboBox has changed the selected item.
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class FilterComboBoxAction extends AbstractAction { protected class FilterComboBoxAction extends AbstractAction {
protected FilterComboBoxAction() { protected FilterComboBoxAction() {
super("FilterComboBoxAction"); super("FilterComboBoxAction");
@ -1349,6 +1363,7 @@ public class AquaFileChooserUI extends FileChooserUI {
/** /**
* Acts when DirectoryComboBox has changed the selected item. * Acts when DirectoryComboBox has changed the selected item.
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class DirectoryComboBoxAction extends AbstractAction { protected class DirectoryComboBoxAction extends AbstractAction {
protected DirectoryComboBoxAction() { protected DirectoryComboBoxAction() {
super("DirectoryComboBoxAction"); super("DirectoryComboBoxAction");
@ -1360,6 +1375,7 @@ public class AquaFileChooserUI extends FileChooserUI {
} }
// Sorting Table operations // Sorting Table operations
@SuppressWarnings("serial") // Superclass is not serializable across versions
class JSortingTableHeader extends JTableHeader { class JSortingTableHeader extends JTableHeader {
public JSortingTableHeader(final TableColumnModel cm) { public JSortingTableHeader(final TableColumnModel cm) {
super(cm); super(cm);
@ -1396,6 +1412,7 @@ public class AquaFileChooserUI extends FileChooserUI {
return label; return label;
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaTableCellRenderer extends DefaultTableCellRenderer implements UIResource { class AquaTableCellRenderer extends DefaultTableCellRenderer implements UIResource {
public Component getTableCellRendererComponent(final JTable localTable, final Object value, final boolean isSelected, final boolean hasFocus, final int row, final int column) { public Component getTableCellRendererComponent(final JTable localTable, final Object value, final boolean isSelected, final boolean hasFocus, final int row, final int column) {
if (localTable != null) { if (localTable != null) {
@ -1474,6 +1491,7 @@ public class AquaFileChooserUI extends FileChooserUI {
tPanel.add(labelArea); tPanel.add(labelArea);
// separator line // separator line
@SuppressWarnings("serial") // anonymous class
final JSeparator sep = new JSeparator(){ final JSeparator sep = new JSeparator(){
public Dimension getPreferredSize() { public Dimension getPreferredSize() {
return new Dimension(((JComponent)getParent()).getWidth(), 3); return new Dimension(((JComponent)getParent()).getWidth(), 3);
@ -1761,6 +1779,7 @@ public class AquaFileChooserUI extends FileChooserUI {
return p; return p;
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
protected class ScrollPaneCornerPanel extends JPanel { protected class ScrollPaneCornerPanel extends JPanel {
final Border border = UIManager.getBorder("TableHeader.cellBorder"); final Border border = UIManager.getBorder("TableHeader.cellBorder");
@ -2225,6 +2244,7 @@ public class AquaFileChooserUI extends FileChooserUI {
} }
// See FileRenderer - documents in Save dialogs draw disabled, so they shouldn't be selected // See FileRenderer - documents in Save dialogs draw disabled, so they shouldn't be selected
@SuppressWarnings("serial") // Superclass is not serializable across versions
class MacListSelectionModel extends DefaultListSelectionModel { class MacListSelectionModel extends DefaultListSelectionModel {
AquaFileSystemModel fModel; AquaFileSystemModel fModel;
@ -2315,6 +2335,7 @@ public class AquaFileChooserUI extends FileChooserUI {
// Convenience, to translate from the JList directory view to the Mac-style JTable // Convenience, to translate from the JList directory view to the Mac-style JTable
// & minimize diffs between this and BasicFileChooserUI // & minimize diffs between this and BasicFileChooserUI
@SuppressWarnings("serial") // Superclass is not serializable across versions
class JTableExtension extends JTable { class JTableExtension extends JTable {
public void setSelectedIndex(final int index) { public void setSelectedIndex(final int index) {
getSelectionModel().setSelectionInterval(index, index); getSelectionModel().setSelectionInterval(index, index);

3
jdk/src/macosx/classes/com/apple/laf/AquaFileSystemModel.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -39,6 +39,7 @@ import javax.swing.table.AbstractTableModel;
* *
* Some of it came from BasicDirectoryModel * Some of it came from BasicDirectoryModel
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaFileSystemModel extends AbstractTableModel implements PropertyChangeListener { class AquaFileSystemModel extends AbstractTableModel implements PropertyChangeListener {
private final JTable fFileList; private final JTable fFileList;
private LoadFilesThread loadThread = null; private LoadFilesThread loadThread = null;

3
jdk/src/macosx/classes/com/apple/laf/AquaFileView.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -34,6 +34,7 @@ import javax.swing.filechooser.FileView;
import com.apple.laf.AquaUtils.RecyclableSingleton; import com.apple.laf.AquaUtils.RecyclableSingleton;
@SuppressWarnings("serial") // JDK implementation class
class AquaFileView extends FileView { class AquaFileView extends FileView {
private static final boolean DEBUG = false; private static final boolean DEBUG = false;

3
jdk/src/macosx/classes/com/apple/laf/AquaFonts.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -34,6 +34,7 @@ import javax.swing.plaf.*;
import com.apple.laf.AquaUtils.RecyclableSingleton; import com.apple.laf.AquaUtils.RecyclableSingleton;
@SuppressWarnings("serial") // JDK implementation class
public class AquaFonts { public class AquaFonts {
private static final String MAC_DEFAULT_FONT_NAME = "Lucida Grande"; private static final String MAC_DEFAULT_FONT_NAME = "Lucida Grande";

10
jdk/src/macosx/classes/com/apple/laf/AquaIcon.java
View File

@ -295,14 +295,8 @@ public class AquaIcon {
} }
Image createImage() { Image createImage() {
int w = getIconWidth(); return AquaUtils.getCImageCreator().createSystemImageFromSelector(
int h = getIconHeight(); selector, getIconWidth(), getIconHeight());
return new AquaImageFactory.MultiResolutionIconImage(
AquaUtils.getCImageCreator().createSystemImageFromSelector(
selector, w, h),
AquaUtils.getCImageCreator().createSystemImageFromSelector(
selector, 2 * w, 2 * h)
);
} }
} }
} }

61
jdk/src/macosx/classes/com/apple/laf/AquaImageFactory.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -125,16 +125,14 @@ public class AquaImageFactory {
private static final int kAlertIconSize = 64; private static final int kAlertIconSize = 64;
static IconUIResource getAppIconCompositedOn(final Image background) { static IconUIResource getAppIconCompositedOn(final Image background) {
final BufferedImage iconImage = getAppIconImageCompositedOn(background, 1); if (background instanceof MultiResolutionBufferedImage) {
int width = background.getWidth(null);
if (background instanceof MultiResolutionIconImage) { Image mrIconImage = ((MultiResolutionBufferedImage) background).map(
BufferedImage background2x rv -> getAppIconImageCompositedOn(rv, rv.getWidth(null) / width));
= ((MultiResolutionIconImage) background).resolutionVariant; return new IconUIResource(new ImageIcon(mrIconImage));
BufferedImage icon2xImage = getAppIconImageCompositedOn(background2x, 2);
return new IconUIResource(new ImageIcon(
new MultiResolutionIconImage(iconImage, icon2xImage)));
} }
BufferedImage iconImage = getAppIconImageCompositedOn(background, 1);
return new IconUIResource(new ImageIcon(iconImage)); return new IconUIResource(new ImageIcon(iconImage));
} }
@ -248,6 +246,7 @@ public class AquaImageFactory {
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class InvertableImageIcon extends ImageIcon implements InvertableIcon, UIResource { static class InvertableImageIcon extends ImageIcon implements InvertableIcon, UIResource {
Icon invertedImage; Icon invertedImage;
public InvertableImageIcon(final Image image) { public InvertableImageIcon(final Image image) {
@ -312,10 +311,16 @@ public class AquaImageFactory {
return icon; return icon;
} }
Image icon2x = AquaUtils.getCImageCreator().createImageFromName( int w = icon.getWidth(null);
imageName, 2 * icon.getWidth(null), 2 * icon.getHeight(null)); int h = icon.getHeight(null);
return new MultiResolutionBufferedImage(
BufferedImage.TYPE_INT_ARGB_PRE, 0, icon, icon2x); Dimension[] sizes = new Dimension[]{
new Dimension(w, h), new Dimension(2 * w, 2 * h)
};
return new MultiResolutionBufferedImage(icon, sizes, (width, height) ->
AquaUtils.getCImageCreator().createImageFromName(
imageName, width, height));
} }
public static class NineSliceMetrics { public static class NineSliceMetrics {
@ -480,6 +485,7 @@ public class AquaImageFactory {
// when we use SystemColors, we need to proxy the color with something that implements UIResource, // when we use SystemColors, we need to proxy the color with something that implements UIResource,
// so that it will be uninstalled when the look and feel is changed. // so that it will be uninstalled when the look and feel is changed.
@SuppressWarnings("serial") // JDK implementation class
private static class SystemColorProxy extends Color implements UIResource { private static class SystemColorProxy extends Color implements UIResource {
final Color color; final Color color;
public SystemColorProxy(final Color color) { public SystemColorProxy(final Color color) {
@ -524,29 +530,4 @@ public class AquaImageFactory {
public static Color getSelectionInactiveForegroundColorUIResource() { public static Color getSelectionInactiveForegroundColorUIResource() {
return new SystemColorProxy(LWCToolkit.getAppleColor(LWCToolkit.INACTIVE_SELECTION_FOREGROUND_COLOR)); return new SystemColorProxy(LWCToolkit.getAppleColor(LWCToolkit.INACTIVE_SELECTION_FOREGROUND_COLOR));
} }
}
static class MultiResolutionIconImage extends BufferedImage
implements MultiResolutionImage {
BufferedImage resolutionVariant;
public MultiResolutionIconImage(BufferedImage image, BufferedImage resolutionVariant) {
super(image.getWidth(), image.getHeight(), image.getType());
this.resolutionVariant = resolutionVariant;
Graphics g = getGraphics();
g.drawImage(image, 0, 0, null);
g.dispose();
}
@Override
public Image getResolutionVariant(int width, int height) {
return ((width <= getWidth() && height <= getHeight()))
? this : resolutionVariant;
}
@Override
public List<Image> getResolutionVariants() {
return Arrays.asList(this, resolutionVariant);
}
}
}

4
jdk/src/macosx/classes/com/apple/laf/AquaInternalFrameDockIconUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -167,6 +167,7 @@ public class AquaInternalFrameDockIconUI extends DesktopIconUI implements MouseL
fFrame.putClientProperty(CACHED_FRAME_ICON_KEY, null); fFrame.putClientProperty(CACHED_FRAME_ICON_KEY, null);
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class ScaledImageLabel extends JLabel { class ScaledImageLabel extends JLabel {
ScaledImageLabel() { ScaledImageLabel() {
super(null, null, CENTER); super(null, null, CENTER);
@ -226,6 +227,7 @@ public class AquaInternalFrameDockIconUI extends DesktopIconUI implements MouseL
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class DockLabel extends JLabel { class DockLabel extends JLabel {
final static int NUB_HEIGHT = 7; final static int NUB_HEIGHT = 7;
final static int ROUND_ADDITIONAL_HEIGHT = 8; final static int ROUND_ADDITIONAL_HEIGHT = 8;

3
jdk/src/macosx/classes/com/apple/laf/AquaInternalFrameManager.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -53,6 +53,7 @@ import javax.swing.*;
* *
* @see com.sun.java.swing.plaf.windows.WindowsDesktopManager * @see com.sun.java.swing.plaf.windows.WindowsDesktopManager
*/ */
@SuppressWarnings("serial") // JDK implementation class
public class AquaInternalFrameManager extends DefaultDesktopManager { public class AquaInternalFrameManager extends DefaultDesktopManager {
// Variables // Variables

4
jdk/src/macosx/classes/com/apple/laf/AquaInternalFramePaneUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -116,6 +116,7 @@ public class AquaInternalFramePaneUI extends BasicDesktopPaneUI implements Mouse
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class Dock extends JComponent implements Border { class Dock extends JComponent implements Border {
static final int DOCK_EDGE_SLACK = 8; static final int DOCK_EDGE_SLACK = 8;
@ -185,6 +186,7 @@ public class AquaInternalFramePaneUI extends BasicDesktopPaneUI implements Mouse
} }
} }
@SuppressWarnings("serial") // JDK implementation class
class AquaDockingDesktopManager extends AquaInternalFrameManager { class AquaDockingDesktopManager extends AquaInternalFrameManager {
public void openFrame(final JInternalFrame f) { public void openFrame(final JInternalFrame f) {
final JInternalFrame.JDesktopIcon desktopIcon = f.getDesktopIcon(); final JInternalFrame.JDesktopIcon desktopIcon = f.getDesktopIcon();

4
jdk/src/macosx/classes/com/apple/laf/AquaInternalFrameUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -753,6 +753,7 @@ public class AquaInternalFrameUI extends BasicInternalFrameUI implements SwingCo
} }
}; };
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class CompoundUIBorder extends CompoundBorder implements UIResource { static class CompoundUIBorder extends CompoundBorder implements UIResource {
public CompoundUIBorder(final Border inside, final Border outside) { super(inside, outside); } public CompoundUIBorder(final Border inside, final Border outside) { super(inside, outside); }
} }
@ -796,6 +797,7 @@ public class AquaInternalFrameUI extends BasicInternalFrameUI implements SwingCo
} }
}; };
@SuppressWarnings("serial") // Superclass is not serializable across versions
class ResizeBox extends JLabel implements MouseListener, MouseMotionListener, MouseWheelListener, ComponentListener, PropertyChangeListener, UIResource { class ResizeBox extends JLabel implements MouseListener, MouseMotionListener, MouseWheelListener, ComponentListener, PropertyChangeListener, UIResource {
final JLayeredPane layeredPane; final JLayeredPane layeredPane;
Dimension originalSize; Dimension originalSize;

4
jdk/src/macosx/classes/com/apple/laf/AquaKeyBindings.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -528,6 +528,7 @@ public class AquaKeyBindings {
} }
// extracted and adapted from DefaultEditorKit in 1.6 // extracted and adapted from DefaultEditorKit in 1.6
@SuppressWarnings("serial") // Superclass is not serializable across versions
static abstract class DeleteWordAction extends TextAction { static abstract class DeleteWordAction extends TextAction {
public DeleteWordAction(final String name) { super(name); } public DeleteWordAction(final String name) { super(name); }
@ -565,6 +566,7 @@ public class AquaKeyBindings {
final TextAction pageUpMultilineAction = new AquaMultilineAction(pageUpMultiline, DefaultEditorKit.pageUpAction, DefaultEditorKit.beginAction); final TextAction pageUpMultilineAction = new AquaMultilineAction(pageUpMultiline, DefaultEditorKit.pageUpAction, DefaultEditorKit.beginAction);
final TextAction pageDownMultilineAction = new AquaMultilineAction(pageDownMultiline, DefaultEditorKit.pageDownAction, DefaultEditorKit.endAction); final TextAction pageDownMultilineAction = new AquaMultilineAction(pageDownMultiline, DefaultEditorKit.pageDownAction, DefaultEditorKit.endAction);
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class AquaMultilineAction extends TextAction { static class AquaMultilineAction extends TextAction {
final String targetActionName; final String targetActionName;
final String proxyActionName; final String proxyActionName;

3
jdk/src/macosx/classes/com/apple/laf/AquaListUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -67,6 +67,7 @@ public class AquaListUI extends BasicListUI {
list.getActionMap().put("aquaEnd", new AquaHomeEndAction(false)); list.getActionMap().put("aquaEnd", new AquaHomeEndAction(false));
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class AquaHomeEndAction extends AbstractAction { static class AquaHomeEndAction extends AbstractAction {
private boolean fHomeAction = false; private boolean fHomeAction = false;

110
jdk/src/macosx/classes/com/apple/laf/AquaLookAndFeel.java
View File

@ -32,19 +32,19 @@ import java.util.*;
import javax.swing.*; import javax.swing.*;
import javax.swing.border.Border; import javax.swing.border.Border;
import javax.swing.plaf.*; import javax.swing.plaf.*;
import javax.swing.plaf.basic.BasicBorders;
import javax.swing.plaf.basic.BasicLookAndFeel; import javax.swing.plaf.basic.BasicLookAndFeel;
import static javax.swing.UIDefaults.LazyValue;
import sun.swing.*; import sun.swing.*;
import apple.laf.*; import apple.laf.*;
@SuppressWarnings("serial") // Superclass is not serializable across versions
public class AquaLookAndFeel extends BasicLookAndFeel { public class AquaLookAndFeel extends BasicLookAndFeel {
static final String sOldPropertyPrefix = "com.apple.macos."; // old prefix for things like 'useScreenMenuBar' static final String sOldPropertyPrefix = "com.apple.macos."; // old prefix for things like 'useScreenMenuBar'
static final String sPropertyPrefix = "apple.laf."; // new prefix for things like 'useScreenMenuBar' static final String sPropertyPrefix = "apple.laf."; // new prefix for things like 'useScreenMenuBar'
// for lazy initalizers. Following the pattern from metal. // for lazy initalizers. Following the pattern from metal.
private static final String PKG_PREFIX = "com.apple.laf."; private static final String PKG_PREFIX = "com.apple.laf.";
private static final String kAquaImageFactoryName = PKG_PREFIX + "AquaImageFactory";
private static final String kAquaFontsName = PKG_PREFIX + "AquaFonts";
/** /**
* Return a short string that identifies this look and feel, e.g. * Return a short string that identifies this look and feel, e.g.
@ -320,17 +320,21 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
// our launch times of Swing apps. // our launch times of Swing apps.
// *** Text value objects // *** Text value objects
final Object marginBorder = new SwingLazyValue("javax.swing.plaf.basic.BasicBorders$MarginBorder"); final LazyValue marginBorder = t -> new BasicBorders.MarginBorder();
final Object zero = new Integer(0); final int zero = 0;
final Object editorMargin = zeroInsets; // this is not correct - look at TextEdit to determine the right margin final Object editorMargin = zeroInsets; // this is not correct - look at TextEdit to determine the right margin
final Object textCaretBlinkRate = new Integer(500); final int textCaretBlinkRate = 500;
final Object textFieldBorder = new SwingLazyValue(PKG_PREFIX + "AquaTextFieldBorder", "getTextFieldBorder"); final LazyValue textFieldBorder = t ->
AquaTextFieldBorder.getTextFieldBorder();
final Object textAreaBorder = marginBorder; // text areas have no real border - radar 311073 final Object textAreaBorder = marginBorder; // text areas have no real border - radar 311073
final Object scollListBorder = new SwingLazyValue(PKG_PREFIX + "AquaScrollRegionBorder", "getScrollRegionBorder"); final LazyValue scollListBorder = t ->
final Object aquaTitledBorder = new SwingLazyValue(PKG_PREFIX + "AquaGroupBorder", "getBorderForTitledBorder"); AquaScrollRegionBorder.getScrollRegionBorder();
final Object aquaInsetBorder = new SwingLazyValue(PKG_PREFIX + "AquaGroupBorder", "getTitlelessBorder"); final LazyValue aquaTitledBorder = t ->
AquaGroupBorder.getBorderForTitledBorder();
final LazyValue aquaInsetBorder = t ->
AquaGroupBorder.getTitlelessBorder();
final Border listHeaderBorder = AquaTableHeaderBorder.getListHeaderBorder(); final Border listHeaderBorder = AquaTableHeaderBorder.getListHeaderBorder();
final Border zeroBorder = new BorderUIResource.EmptyBorderUIResource(0, 0, 0, 0); final Border zeroBorder = new BorderUIResource.EmptyBorderUIResource(0, 0, 0, 0);
@ -352,7 +356,8 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
final Color textPasswordFieldCapsLockIconColor = mediumTranslucentBlack; final Color textPasswordFieldCapsLockIconColor = mediumTranslucentBlack;
final Object internalFrameBorder = new SwingLazyValue("javax.swing.plaf.basic.BasicBorders", "getInternalFrameBorder"); final LazyValue internalFrameBorder = t ->
BasicBorders.getInternalFrameBorder();
final Color desktopBackgroundColor = new ColorUIResource(new Color(65, 105, 170));//SystemColor.desktop final Color desktopBackgroundColor = new ColorUIResource(new Color(65, 105, 170));//SystemColor.desktop
final Color focusRingColor = AquaImageFactory.getFocusRingColorUIResource(); final Color focusRingColor = AquaImageFactory.getFocusRingColorUIResource();
@ -363,11 +368,12 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
final Color tabBackgroundColor = windowBackgroundColor; final Color tabBackgroundColor = windowBackgroundColor;
final Color controlBackgroundColor = windowBackgroundColor; final Color controlBackgroundColor = windowBackgroundColor;
final Object controlFont = new SwingLazyValue(kAquaFontsName, "getControlTextFont"); final LazyValue controlFont = t -> AquaFonts.getControlTextFont();
final Object controlSmallFont = new SwingLazyValue(kAquaFontsName, "getControlTextSmallFont"); final LazyValue controlSmallFont = t ->
final Object alertHeaderFont = new SwingLazyValue(kAquaFontsName, "getAlertHeaderFont"); AquaFonts.getControlTextSmallFont();
final Object menuFont = new SwingLazyValue(kAquaFontsName, "getMenuFont"); final LazyValue alertHeaderFont = t -> AquaFonts.getAlertHeaderFont();
final Object viewFont = new SwingLazyValue(kAquaFontsName, "getViewFont"); final LazyValue menuFont = t -> AquaFonts.getMenuFont();
final LazyValue viewFont = t -> AquaFonts.getViewFont();
final Color menuBackgroundColor = new ColorUIResource(Color.white); final Color menuBackgroundColor = new ColorUIResource(Color.white);
final Color menuForegroundColor = black; final Color menuForegroundColor = black;
@ -389,10 +395,14 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
}); });
// sja testing // sja testing
final Object confirmIcon = new SwingLazyValue(kAquaImageFactoryName, "getConfirmImageIcon"); // AquaImageFactory.getConfirmImageIcon(); final LazyValue confirmIcon = t ->
final Object cautionIcon = new SwingLazyValue(kAquaImageFactoryName, "getCautionImageIcon"); // AquaImageFactory.getCautionImageIcon(); AquaImageFactory.getConfirmImageIcon();
final Object stopIcon = new SwingLazyValue(kAquaImageFactoryName, "getStopImageIcon"); // AquaImageFactory.getStopImageIcon(); final LazyValue cautionIcon = t ->
final Object securityIcon = new SwingLazyValue(kAquaImageFactoryName, "getLockImageIcon"); // AquaImageFactory.getLockImageIcon(); AquaImageFactory.getCautionImageIcon();
final LazyValue stopIcon = t ->
AquaImageFactory.getStopImageIcon();
final LazyValue securityIcon = t ->
AquaImageFactory.getLockImageIcon();
final AquaKeyBindings aquaKeyBindings = AquaKeyBindings.instance(); final AquaKeyBindings aquaKeyBindings = AquaKeyBindings.instance();
@ -404,7 +414,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"Button.foreground", black, "Button.foreground", black,
"Button.disabledText", disabled, "Button.disabledText", disabled,
"Button.select", selected, "Button.select", selected,
"Button.border", new SwingLazyValue(PKG_PREFIX + "AquaButtonBorder", "getDynamicButtonBorder"), "Button.border",(LazyValue) t -> AquaButtonBorder.getDynamicButtonBorder(),
"Button.font", controlFont, "Button.font", controlFont,
"Button.textIconGap", new Integer(4), "Button.textIconGap", new Integer(4),
"Button.textShiftOffset", zero, // radar 3308129 - aqua doesn't move images when pressed. "Button.textShiftOffset", zero, // radar 3308129 - aqua doesn't move images when pressed.
@ -416,7 +426,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"CheckBox.foreground", black, "CheckBox.foreground", black,
"CheckBox.disabledText", disabled, "CheckBox.disabledText", disabled,
"CheckBox.select", selected, "CheckBox.select", selected,
"CheckBox.icon", new SwingLazyValue(PKG_PREFIX + "AquaButtonCheckBoxUI", "getSizingCheckBoxIcon"), "CheckBox.icon",(LazyValue) t -> AquaButtonCheckBoxUI.getSizingCheckBoxIcon(),
"CheckBox.font", controlFont, "CheckBox.font", controlFont,
"CheckBox.border", AquaButtonBorder.getBevelButtonBorder(), "CheckBox.border", AquaButtonBorder.getBevelButtonBorder(),
"CheckBox.margin", new InsetsUIResource(1, 1, 0, 1), "CheckBox.margin", new InsetsUIResource(1, 1, 0, 1),
@ -441,8 +451,8 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"CheckBoxMenuItem.border", menuBorder, // for inset calculation "CheckBoxMenuItem.border", menuBorder, // for inset calculation
"CheckBoxMenuItem.margin", menuItemMargin, "CheckBoxMenuItem.margin", menuItemMargin,
"CheckBoxMenuItem.borderPainted", Boolean.TRUE, "CheckBoxMenuItem.borderPainted", Boolean.TRUE,
"CheckBoxMenuItem.checkIcon", new SwingLazyValue(kAquaImageFactoryName, "getMenuItemCheckIcon"), "CheckBoxMenuItem.checkIcon",(LazyValue) t -> AquaImageFactory.getMenuItemCheckIcon(),
"CheckBoxMenuItem.dashIcon", new SwingLazyValue(kAquaImageFactoryName, "getMenuItemDashIcon"), "CheckBoxMenuItem.dashIcon",(LazyValue) t -> AquaImageFactory.getMenuItemDashIcon(),
//"CheckBoxMenuItem.arrowIcon", null, //"CheckBoxMenuItem.arrowIcon", null,
"ColorChooser.background", panelBackgroundColor, "ColorChooser.background", panelBackgroundColor,
@ -538,10 +548,10 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
/* Default frame icons are undefined for Basic. */ /* Default frame icons are undefined for Basic. */
"InternalFrame.closeIcon", new SwingLazyValue(PKG_PREFIX + "AquaInternalFrameUI", "exportCloseIcon"), "InternalFrame.closeIcon",(LazyValue) t -> AquaInternalFrameUI.exportCloseIcon(),
"InternalFrame.maximizeIcon", new SwingLazyValue(PKG_PREFIX + "AquaInternalFrameUI", "exportZoomIcon"), "InternalFrame.maximizeIcon",(LazyValue) t -> AquaInternalFrameUI.exportZoomIcon(),
"InternalFrame.iconifyIcon", new SwingLazyValue(PKG_PREFIX + "AquaInternalFrameUI", "exportMinimizeIcon"), "InternalFrame.iconifyIcon",(LazyValue) t -> AquaInternalFrameUI.exportMinimizeIcon(),
"InternalFrame.minimizeIcon", new SwingLazyValue(PKG_PREFIX + "AquaInternalFrameUI", "exportMinimizeIcon"), "InternalFrame.minimizeIcon",(LazyValue) t -> AquaInternalFrameUI.exportMinimizeIcon(),
// this could be either grow or icon // this could be either grow or icon
// we decided to make it icon so that anyone who uses // we decided to make it icon so that anyone who uses
// these for ui will have different icons for max and min // these for ui will have different icons for max and min
@ -595,11 +605,11 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"List.border", null, "List.border", null,
"List.cellRenderer", listCellRendererActiveValue, "List.cellRenderer", listCellRendererActiveValue,
"List.sourceListBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaListUI", "getSourceListBackgroundPainter"), "List.sourceListBackgroundPainter",(LazyValue) t -> AquaListUI.getSourceListBackgroundPainter(),
"List.sourceListSelectionBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaListUI", "getSourceListSelectionBackgroundPainter"), "List.sourceListSelectionBackgroundPainter",(LazyValue) t -> AquaListUI.getSourceListSelectionBackgroundPainter(),
"List.sourceListFocusedSelectionBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaListUI", "getSourceListFocusedSelectionBackgroundPainter"), "List.sourceListFocusedSelectionBackgroundPainter",(LazyValue) t -> AquaListUI.getSourceListFocusedSelectionBackgroundPainter(),
"List.evenRowBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaListUI", "getListEvenBackgroundPainter"), "List.evenRowBackgroundPainter",(LazyValue) t -> AquaListUI.getListEvenBackgroundPainter(),
"List.oddRowBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaListUI", "getListOddBackgroundPainter"), "List.oddRowBackgroundPainter",(LazyValue) t -> AquaListUI.getListOddBackgroundPainter(),
// <rdar://Problem/3743210> The modifier for the Mac is meta, not control. // <rdar://Problem/3743210> The modifier for the Mac is meta, not control.
"List.focusInputMap", aquaKeyBindings.getListInputMap(), "List.focusInputMap", aquaKeyBindings.getListInputMap(),
@ -623,7 +633,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"Menu.borderPainted", Boolean.FALSE, "Menu.borderPainted", Boolean.FALSE,
"Menu.margin", menuItemMargin, "Menu.margin", menuItemMargin,
//"Menu.checkIcon", emptyCheckIcon, // A non-drawing GlyphIcon to make the spacing consistent //"Menu.checkIcon", emptyCheckIcon, // A non-drawing GlyphIcon to make the spacing consistent
"Menu.arrowIcon", new SwingLazyValue(kAquaImageFactoryName, "getMenuArrowIcon"), "Menu.arrowIcon",(LazyValue) t -> AquaImageFactory.getMenuArrowIcon(),
"Menu.consumesTabs", Boolean.TRUE, "Menu.consumesTabs", Boolean.TRUE,
"Menu.menuPopupOffsetY", new Integer(1), "Menu.menuPopupOffsetY", new Integer(1),
"Menu.submenuPopupOffsetY", new Integer(-4), "Menu.submenuPopupOffsetY", new Integer(-4),
@ -637,8 +647,8 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"MenuBar.selectionForeground", menuSelectedForegroundColor, "MenuBar.selectionForeground", menuSelectedForegroundColor,
"MenuBar.disabledBackground", menuDisabledBackgroundColor, //ThemeBrush.GetThemeBrushForMenu(false, false), // not a menu item, not selected "MenuBar.disabledBackground", menuDisabledBackgroundColor, //ThemeBrush.GetThemeBrushForMenu(false, false), // not a menu item, not selected
"MenuBar.disabledForeground", menuDisabledForegroundColor, "MenuBar.disabledForeground", menuDisabledForegroundColor,
"MenuBar.backgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaMenuPainter", "getMenuBarPainter"), "MenuBar.backgroundPainter",(LazyValue) t -> AquaMenuPainter.getMenuBarPainter(),
"MenuBar.selectedBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaMenuPainter", "getSelectedMenuBarItemPainter"), "MenuBar.selectedBackgroundPainter",(LazyValue) t -> AquaMenuPainter.getSelectedMenuBarItemPainter(),
"MenuItem.font", menuFont, "MenuItem.font", menuFont,
"MenuItem.acceleratorFont", menuFont, "MenuItem.acceleratorFont", menuFont,
@ -656,7 +666,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"MenuItem.borderPainted", Boolean.TRUE, "MenuItem.borderPainted", Boolean.TRUE,
//"MenuItem.checkIcon", emptyCheckIcon, // A non-drawing GlyphIcon to make the spacing consistent //"MenuItem.checkIcon", emptyCheckIcon, // A non-drawing GlyphIcon to make the spacing consistent
//"MenuItem.arrowIcon", null, //"MenuItem.arrowIcon", null,
"MenuItem.selectedBackgroundPainter", new SwingLazyValue(PKG_PREFIX + "AquaMenuPainter", "getSelectedMenuItemPainter"), "MenuItem.selectedBackgroundPainter",(LazyValue) t -> AquaMenuPainter.getSelectedMenuItemPainter(),
// *** OptionPane // *** OptionPane
// You can additionaly define OptionPane.messageFont which will // You can additionaly define OptionPane.messageFont which will
@ -732,7 +742,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"RadioButton.foreground", black, "RadioButton.foreground", black,
"RadioButton.disabledText", disabled, "RadioButton.disabledText", disabled,
"RadioButton.select", selected, "RadioButton.select", selected,
"RadioButton.icon", new SwingLazyValue(PKG_PREFIX + "AquaButtonRadioUI", "getSizingRadioButtonIcon"), "RadioButton.icon",(LazyValue) t -> AquaButtonRadioUI.getSizingRadioButtonIcon(),
"RadioButton.font", controlFont, "RadioButton.font", controlFont,
"RadioButton.border", AquaButtonBorder.getBevelButtonBorder(), "RadioButton.border", AquaButtonBorder.getBevelButtonBorder(),
"RadioButton.margin", new InsetsUIResource(1, 1, 0, 1), "RadioButton.margin", new InsetsUIResource(1, 1, 0, 1),
@ -752,8 +762,8 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"RadioButtonMenuItem.border", menuBorder, // for inset calculation "RadioButtonMenuItem.border", menuBorder, // for inset calculation
"RadioButtonMenuItem.margin", menuItemMargin, "RadioButtonMenuItem.margin", menuItemMargin,
"RadioButtonMenuItem.borderPainted", Boolean.TRUE, "RadioButtonMenuItem.borderPainted", Boolean.TRUE,
"RadioButtonMenuItem.checkIcon", new SwingLazyValue(kAquaImageFactoryName, "getMenuItemCheckIcon"), "RadioButtonMenuItem.checkIcon",(LazyValue) t -> AquaImageFactory.getMenuItemCheckIcon(),
"RadioButtonMenuItem.dashIcon", new SwingLazyValue(kAquaImageFactoryName, "getMenuItemDashIcon"), "RadioButtonMenuItem.dashIcon",(LazyValue) t -> AquaImageFactory.getMenuItemDashIcon(),
//"RadioButtonMenuItem.arrowIcon", null, //"RadioButtonMenuItem.arrowIcon", null,
"Separator.background", null, "Separator.background", null,
@ -808,7 +818,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"SplitPane.border", scollListBorder, "SplitPane.border", scollListBorder,
"SplitPane.dividerSize", new Integer(9), //$ "SplitPane.dividerSize", new Integer(9), //$
"SplitPaneDivider.border", null, // AquaSplitPaneDividerUI draws it "SplitPaneDivider.border", null, // AquaSplitPaneDividerUI draws it
"SplitPaneDivider.horizontalGradientVariant", new SwingLazyValue(PKG_PREFIX + "AquaSplitPaneDividerUI", "getHorizontalSplitDividerGradientVariant"), "SplitPaneDivider.horizontalGradientVariant",(LazyValue) t -> AquaSplitPaneDividerUI.getHorizontalSplitDividerGradientVariant(),
// *** TabbedPane // *** TabbedPane
"TabbedPane.font", controlFont, "TabbedPane.font", controlFont,
@ -918,7 +928,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
// "ToggleButton.disabledBackground", getControl(), // "ToggleButton.disabledBackground", getControl(),
// "ToggleButton.disabledSelectedBackground", getControlShadow(), // "ToggleButton.disabledSelectedBackground", getControlShadow(),
//"ToggleButton.focus", getFocusColor(), //"ToggleButton.focus", getFocusColor(),
"ToggleButton.border", new SwingLazyValue(PKG_PREFIX + "AquaButtonBorder", "getDynamicButtonBorder"), // sja make this lazy! "ToggleButton.border",(LazyValue) t -> AquaButtonBorder.getDynamicButtonBorder(), // sja make this lazy!
"ToggleButton.font", controlFont, "ToggleButton.font", controlFont,
"ToggleButton.focusInputMap", controlFocusInputMap, "ToggleButton.focusInputMap", controlFocusInputMap,
"ToggleButton.margin", new InsetsUIResource(2, 2, 2, 2), "ToggleButton.margin", new InsetsUIResource(2, 2, 2, 2),
@ -931,7 +941,7 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"ToolBar.dockingForeground", selectionBackground, "ToolBar.dockingForeground", selectionBackground,
"ToolBar.floatingBackground", panelBackgroundColor, "ToolBar.floatingBackground", panelBackgroundColor,
"ToolBar.floatingForeground", new ColorUIResource(Color.darkGray), "ToolBar.floatingForeground", new ColorUIResource(Color.darkGray),
"ToolBar.border", new SwingLazyValue(PKG_PREFIX + "AquaToolBarUI", "getToolBarBorder"), "ToolBar.border",(LazyValue) t -> AquaToolBarUI.getToolBarBorder(),
"ToolBar.borderHandleColor", toolbarDragHandleColor, "ToolBar.borderHandleColor", toolbarDragHandleColor,
//"ToolBar.separatorSize", new DimensionUIResource( 10, 10 ), //"ToolBar.separatorSize", new DimensionUIResource( 10, 10 ),
"ToolBar.separatorSize", null, "ToolBar.separatorSize", null,
@ -967,12 +977,12 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
"Tree.rightChildIndent", new Integer(13),//$ "Tree.rightChildIndent", new Integer(13),//$
"Tree.rowHeight", new Integer(19),// iconHeight + 3, to match finder - a zero would have the renderer decide, except that leaves the icons touching "Tree.rowHeight", new Integer(19),// iconHeight + 3, to match finder - a zero would have the renderer decide, except that leaves the icons touching
"Tree.scrollsOnExpand", Boolean.FALSE, "Tree.scrollsOnExpand", Boolean.FALSE,
"Tree.openIcon", new SwingLazyValue(kAquaImageFactoryName, "getTreeOpenFolderIcon"), // Open folder icon "Tree.openIcon",(LazyValue) t -> AquaImageFactory.getTreeOpenFolderIcon(), // Open folder icon
"Tree.closedIcon", new SwingLazyValue(kAquaImageFactoryName, "getTreeFolderIcon"), // Closed folder icon "Tree.closedIcon",(LazyValue) t -> AquaImageFactory.getTreeFolderIcon(), // Closed folder icon
"Tree.leafIcon", new SwingLazyValue(kAquaImageFactoryName, "getTreeDocumentIcon"), // Document icon "Tree.leafIcon",(LazyValue) t -> AquaImageFactory.getTreeDocumentIcon(), // Document icon
"Tree.expandedIcon", new SwingLazyValue(kAquaImageFactoryName, "getTreeExpandedIcon"), "Tree.expandedIcon",(LazyValue) t -> AquaImageFactory.getTreeExpandedIcon(),
"Tree.collapsedIcon", new SwingLazyValue(kAquaImageFactoryName, "getTreeCollapsedIcon"), "Tree.collapsedIcon",(LazyValue) t -> AquaImageFactory.getTreeCollapsedIcon(),
"Tree.rightToLeftCollapsedIcon", new SwingLazyValue(kAquaImageFactoryName, "getTreeRightToLeftCollapsedIcon"), "Tree.rightToLeftCollapsedIcon",(LazyValue) t -> AquaImageFactory.getTreeRightToLeftCollapsedIcon(),
"Tree.changeSelectionWithFocus", Boolean.TRUE, "Tree.changeSelectionWithFocus", Boolean.TRUE,
"Tree.drawsFocusBorderAroundIcon", Boolean.FALSE, "Tree.drawsFocusBorderAroundIcon", Boolean.FALSE,
@ -1088,4 +1098,4 @@ public class AquaLookAndFeel extends BasicLookAndFeel {
}; };
table.putDefaults(uiDefaults); table.putDefaults(uiDefaults);
} }
} }

3
jdk/src/macosx/classes/com/apple/laf/AquaNativeResources.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -44,6 +44,7 @@ public class AquaNativeResources {
} }
// TODO: removing CColorPaint for now // TODO: removing CColorPaint for now
@SuppressWarnings("serial") // JDK implementation class
static class CColorPaintUIResource extends Color/*CColorPaint*/ implements UIResource { static class CColorPaintUIResource extends Color/*CColorPaint*/ implements UIResource {
// The color passed to this MUST be a retained NSColor, and the CColorPaintUIResource // The color passed to this MUST be a retained NSColor, and the CColorPaintUIResource
// takes ownership of that retain. // takes ownership of that retain.

63
jdk/src/macosx/classes/com/apple/laf/AquaPainter.java
View File

@ -38,6 +38,7 @@ import sun.java2d.*;
import sun.print.*; import sun.print.*;
import apple.laf.*; import apple.laf.*;
import apple.laf.JRSUIUtils.NineSliceMetricsProvider; import apple.laf.JRSUIUtils.NineSliceMetricsProvider;
import sun.awt.image.ImageCache;
abstract class AquaPainter <T extends JRSUIState> { abstract class AquaPainter <T extends JRSUIState> {
static <T extends JRSUIState> AquaPainter<T> create(final T state) { static <T extends JRSUIState> AquaPainter<T> create(final T state) {
@ -155,10 +156,15 @@ abstract class AquaPainter <T extends JRSUIState> {
final ImageCache cache = ImageCache.getInstance(); final ImageCache cache = ImageCache.getInstance();
final int imgW = bounds.width * scale; final int imgW = bounds.width * scale;
final int imgH = bounds.height * scale; final int imgH = bounds.height * scale;
BufferedImage img = (BufferedImage) cache.getImage(config, imgW, imgH, scale, controlState); AquaPixelsKey key = new AquaPixelsKey(config,
imgW, imgH, scale, controlState);
BufferedImage img = (BufferedImage) cache.getImage(key);
if (img == null) { if (img == null) {
img = new BufferedImage(imgW, imgH, BufferedImage.TYPE_INT_ARGB_PRE); img = new BufferedImage(imgW, imgH, BufferedImage.TYPE_INT_ARGB_PRE);
cache.setImage(img, config, imgW, imgH, scale, controlState); if (!controlState.is(JRSUIConstants.Animating.YES)) {
cache.setImage(key, img);
}
final WritableRaster raster = img.getRaster(); final WritableRaster raster = img.getRaster();
final DataBufferInt buffer = (DataBufferInt) raster.getDataBuffer(); final DataBufferInt buffer = (DataBufferInt) raster.getDataBuffer();
@ -172,6 +178,59 @@ abstract class AquaPainter <T extends JRSUIState> {
} }
} }
private static class AquaPixelsKey implements ImageCache.PixelsKey {
private final int pixelCount;
private final int hash;
// key parts
private final GraphicsConfiguration config;
private final int w;
private final int h;
private final int scale;
private final JRSUIState state;
AquaPixelsKey(final GraphicsConfiguration config,
final int w, final int h, final int scale,
final JRSUIState state) {
this.pixelCount = w * h;
this.config = config;
this.w = w;
this.h = h;
this.scale = scale;
this.state = state;
this.hash = hash();
}
public int getPixelCount() {
return pixelCount;
}
private int hash() {
int hash = config != null ? config.hashCode() : 0;
hash = 31 * hash + w;
hash = 31 * hash + h;
hash = 31 * hash + scale;
hash = 31 * hash + state.hashCode();
return hash;
}
@Override
public int hashCode() {
return hash;
}
@Override
public boolean equals(Object obj) {
if (obj instanceof AquaPixelsKey) {
AquaPixelsKey key = (AquaPixelsKey) obj;
return config == key.config && w == key.w && h == key.h
&& scale == key.scale && state.equals(key.state);
}
return false;
}
}
private static class RecyclableJRSUISlicedImageControl private static class RecyclableJRSUISlicedImageControl
extends RecyclableSlicedImageControl { extends RecyclableSlicedImageControl {

5
jdk/src/macosx/classes/com/apple/laf/AquaSpinnerUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -188,6 +188,7 @@ public class AquaSpinnerUI extends SpinnerUI {
return spinner.getEditor().getBaselineResizeBehavior(); return spinner.getEditor().getBaselineResizeBehavior();
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class TransparentButton extends JButton implements SwingConstants { class TransparentButton extends JButton implements SwingConstants {
boolean interceptRepaints = false; boolean interceptRepaints = false;
@ -293,6 +294,7 @@ public class AquaSpinnerUI extends SpinnerUI {
return map; return map;
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private static class ArrowButtonHandler extends AbstractAction implements MouseListener { private static class ArrowButtonHandler extends AbstractAction implements MouseListener {
final javax.swing.Timer autoRepeatTimer; final javax.swing.Timer autoRepeatTimer;
final boolean isNext; final boolean isNext;
@ -461,6 +463,7 @@ public class AquaSpinnerUI extends SpinnerUI {
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class SpinPainter extends JComponent { class SpinPainter extends JComponent {
final AquaPainter<JRSUIState> painter = AquaPainter.create(JRSUIStateFactory.getSpinnerArrows()); final AquaPainter<JRSUIState> painter = AquaPainter.create(JRSUIStateFactory.getSpinnerArrows());

3
jdk/src/macosx/classes/com/apple/laf/AquaSplitPaneDividerUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -39,6 +39,7 @@ import com.apple.laf.AquaUtils.LazyKeyedSingleton;
import com.apple.laf.AquaUtils.RecyclableSingleton; import com.apple.laf.AquaUtils.RecyclableSingleton;
import com.apple.laf.AquaUtils.RecyclableSingletonFromDefaultConstructor; import com.apple.laf.AquaUtils.RecyclableSingletonFromDefaultConstructor;
@SuppressWarnings("serial") // Superclass is not serializable across versions
public class AquaSplitPaneDividerUI extends BasicSplitPaneDivider { public class AquaSplitPaneDividerUI extends BasicSplitPaneDivider {
final AquaPainter<JRSUIState> painter = AquaPainter.create(JRSUIStateFactory.getSplitPaneDivider()); final AquaPainter<JRSUIState> painter = AquaPainter.create(JRSUIStateFactory.getSplitPaneDivider());

8
jdk/src/macosx/classes/com/apple/laf/AquaTabbedPaneCopyFromBasicUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -3237,6 +3237,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private class ScrollableTabViewport extends JViewport implements UIResource { private class ScrollableTabViewport extends JViewport implements UIResource {
public ScrollableTabViewport() { public ScrollableTabViewport() {
super(); super();
@ -3251,6 +3252,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private class ScrollableTabPanel extends JPanel implements UIResource { private class ScrollableTabPanel extends JPanel implements UIResource {
public ScrollableTabPanel() { public ScrollableTabPanel() {
super(null); super(null);
@ -3281,6 +3283,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private class ScrollableTabButton extends javax.swing.plaf.basic.BasicArrowButton implements UIResource, SwingConstants { private class ScrollableTabButton extends javax.swing.plaf.basic.BasicArrowButton implements UIResource, SwingConstants {
public ScrollableTabButton(final int direction) { public ScrollableTabButton(final int direction) {
super(direction, UIManager.getColor("TabbedPane.selected"), UIManager.getColor("TabbedPane.shadow"), UIManager.getColor("TabbedPane.darkShadow"), UIManager.getColor("TabbedPane.highlight")); super(direction, UIManager.getColor("TabbedPane.selected"), UIManager.getColor("TabbedPane.shadow"), UIManager.getColor("TabbedPane.darkShadow"), UIManager.getColor("TabbedPane.highlight"));
@ -3585,6 +3588,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
return htmlViews; return htmlViews;
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private class TabContainer extends JPanel implements UIResource { private class TabContainer extends JPanel implements UIResource {
private boolean notifyTabbedPane = true; private boolean notifyTabbedPane = true;
@ -3629,6 +3633,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
} }
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
private class CroppedEdge extends JPanel implements UIResource { private class CroppedEdge extends JPanel implements UIResource {
private Shape shape; private Shape shape;
private int tabIndex; private int tabIndex;
@ -3708,6 +3713,7 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
* @version 1.6, 11/17/05 * @version 1.6, 11/17/05
* @author Scott Violet * @author Scott Violet
*/ */
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class LazyActionMap extends ActionMapUIResource { static class LazyActionMap extends ActionMapUIResource {
/** /**
* Object to invoke <code>loadActionMap</code> on. This may be * Object to invoke <code>loadActionMap</code> on. This may be

6
jdk/src/macosx/classes/com/apple/laf/AquaTabbedPaneUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -987,7 +987,8 @@ public class AquaTabbedPaneUI extends AquaTabbedPaneCopyFromBasicUI {
if (component == null) { if (component == null) {
menuItem = new JMenuItem(tabPane.getTitleAt(i), tabPane.getIconAt(i)); menuItem = new JMenuItem(tabPane.getTitleAt(i), tabPane.getIconAt(i));
} else { } else {
menuItem = new JMenuItem() { @SuppressWarnings("serial") // anonymous class
JMenuItem tmp = new JMenuItem() {
public void paintComponent(final Graphics g) { public void paintComponent(final Graphics g) {
super.paintComponent(g); super.paintComponent(g);
final Dimension size = component.getSize(); final Dimension size = component.getSize();
@ -1001,6 +1002,7 @@ public class AquaTabbedPaneUI extends AquaTabbedPaneCopyFromBasicUI {
return component.getPreferredSize(); return component.getPreferredSize();
} }
}; };
menuItem = tmp;
} }
final Color background = tabPane.getBackgroundAt(i); final Color background = tabPane.getBackgroundAt(i);

3
jdk/src/macosx/classes/com/apple/laf/AquaTableHeaderBorder.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,6 +36,7 @@ import apple.laf.JRSUIConstants.*;
import com.apple.laf.AquaUtils.RecyclableSingleton; import com.apple.laf.AquaUtils.RecyclableSingleton;
@SuppressWarnings("serial") // Superclass is not serializable across versions
public class AquaTableHeaderBorder extends AbstractBorder { public class AquaTableHeaderBorder extends AbstractBorder {
protected static final int SORT_NONE = 0; protected static final int SORT_NONE = 0;
protected static final int SORT_ASCENDING = 1; protected static final int SORT_ASCENDING = 1;

3
jdk/src/macosx/classes/com/apple/laf/AquaTableHeaderUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -111,6 +111,7 @@ public class AquaTableHeaderUI extends BasicTableHeaderUI {
tableColumn.setHeaderRenderer(renderer); tableColumn.setHeaderRenderer(renderer);
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class AquaTableCellRenderer extends DefaultTableCellRenderer implements UIResource { class AquaTableCellRenderer extends DefaultTableCellRenderer implements UIResource {
public Component getTableCellRendererComponent(final JTable localTable, final Object value, final boolean isSelected, final boolean hasFocus, final int row, final int column) { public Component getTableCellRendererComponent(final JTable localTable, final Object value, final boolean isSelected, final boolean hasFocus, final int row, final int column) {
if (localTable != null) { if (localTable != null) {

4
jdk/src/macosx/classes/com/apple/laf/AquaTextFieldSearch.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -249,6 +249,7 @@ public class AquaTextFieldSearch {
label.setText(promptText); label.setText(promptText);
} }
@SuppressWarnings("serial") // anonymous class inside
protected static JButton getCancelButton(final JTextComponent c) { protected static JButton getCancelButton(final JTextComponent c) {
final JButton b = createButton(c, getCancelIcon()); final JButton b = createButton(c, getCancelIcon());
b.setName("cancel"); b.setName("cancel");
@ -325,6 +326,7 @@ public class AquaTextFieldSearch {
} }
protected boolean doingLayout; protected boolean doingLayout;
@SuppressWarnings("serial") // anonymous class inside
protected LayoutManager getCustomLayout() { protected LayoutManager getCustomLayout() {
// unfortunately, the default behavior of BorderLayout, which accommodates for margins // unfortunately, the default behavior of BorderLayout, which accommodates for margins
// is not what we want, so we "turn off margins" for layout for layout out our buttons // is not what we want, so we "turn off margins" for layout for layout out our buttons

3
jdk/src/macosx/classes/com/apple/laf/AquaToolBarUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -55,6 +55,7 @@ public class AquaToolBarUI extends BasicToolBarUI implements SwingConstants {
} }
/* ToolBarBorder and drag-off handle, based loosly on MetalBumps */ /* ToolBarBorder and drag-off handle, based loosly on MetalBumps */
@SuppressWarnings("serial") // Superclass is not serializable across versions
static class ToolBarBorder extends AbstractBorder implements UIResource, javax.swing.SwingConstants { static class ToolBarBorder extends AbstractBorder implements UIResource, javax.swing.SwingConstants {
protected void fillHandle(final Graphics g, final int x1, final int y1, final int x2, final int y2, final boolean horizontal) { protected void fillHandle(final Graphics g, final int x1, final int y1, final int x2, final int y2, final boolean horizontal) {
g.setColor(UIManager.getColor("ToolBar.borderHandleColor")); g.setColor(UIManager.getColor("ToolBar.borderHandleColor"));

3
jdk/src/macosx/classes/com/apple/laf/AquaTreeUI.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -493,6 +493,7 @@ public class AquaTreeUI extends BasicTreeUI {
tree.getActionMap().put("aquaFullyCollapseNode", new KeyboardExpandCollapseAction(false, true)); tree.getActionMap().put("aquaFullyCollapseNode", new KeyboardExpandCollapseAction(false, true));
} }
@SuppressWarnings("serial") // Superclass is not serializable across versions
class KeyboardExpandCollapseAction extends AbstractAction { class KeyboardExpandCollapseAction extends AbstractAction {
/** /**
* Determines direction to traverse, 1 means expand, -1 means collapse. * Determines direction to traverse, 1 means expand, -1 means collapse.

11
jdk/src/macosx/classes/com/apple/laf/AquaUtils.java
View File

@ -177,16 +177,7 @@ final class AquaUtils {
abstract static class RecyclableSingleton<T> { abstract static class RecyclableSingleton<T> {
final T get() { final T get() {
final AppContext appContext = AppContext.getAppContext(); return AppContext.getSoftReferenceValue(this, () -> getInstance());
SoftReference<T> ref = (SoftReference<T>) appContext.get(this);
if (ref != null) {
final T object = ref.get();
if (object != null) return object;
}
final T object = getInstance();
ref = new SoftReference<T>(object);
appContext.put(this, ref);
return object;
} }
void reset() { void reset() {

266
jdk/src/macosx/classes/com/apple/laf/ImageCache.java
View File

@ -1,266 +0,0 @@
/*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.apple.laf;
import java.awt.*;
import java.lang.ref.*;
import java.util.*;
import java.util.concurrent.locks.*;
import apple.laf.JRSUIConstants;
import apple.laf.JRSUIState;
import com.apple.laf.AquaUtils.RecyclableSingleton;
/**
* ImageCache - A fixed pixel count sized cache of Images keyed by arbitrary set of arguments. All images are held with
* SoftReferences so they will be dropped by the GC if heap memory gets tight. When our size hits max pixel count least
* recently requested images are removed first.
*/
final class ImageCache {
// Ordered Map keyed by args hash, ordered by most recent accessed entry.
private final LinkedHashMap<Integer, PixelCountSoftReference> map = new LinkedHashMap<>(16, 0.75f, true);
// Maximum number of pixels to cache, this is used if maxCount
private final int maxPixelCount;
// The current number of pixels stored in the cache
private int currentPixelCount = 0;
// Lock for concurrent access to map
private final ReadWriteLock lock = new ReentrantReadWriteLock();
// Reference queue for tracking lost softreferences to images in the cache
private final ReferenceQueue<Image> referenceQueue = new ReferenceQueue<>();
// Singleton Instance
private static final RecyclableSingleton<ImageCache> instance = new RecyclableSingleton<ImageCache>() {
@Override
protected ImageCache getInstance() {
return new ImageCache();
}
};
static ImageCache getInstance() {
return instance.get();
}
ImageCache(final int maxPixelCount) {
this.maxPixelCount = maxPixelCount;
}
ImageCache() {
this((8 * 1024 * 1024) / 4); // 8Mb of pixels
}
public void flush() {
lock.writeLock().lock();
try {
map.clear();
} finally {
lock.writeLock().unlock();
}
}
public Image getImage(final GraphicsConfiguration config, final int w,
final int h, final int scale,
final JRSUIState state) {
final int hash = hash(config, w, h, scale, state);
final PixelCountSoftReference ref;
lock.readLock().lock();
try {
ref = map.get(hash);
} finally {
lock.readLock().unlock();
}
// check reference has not been lost and the key truly matches,
// in case of false positive hash match
if (ref != null && ref.equals(config, w, h, scale, state)) {
return ref.get();
}
return null;
}
/**
* Sets the cached image for the specified constraints.
*
* @param image The image to store in cache
* @param config The graphics configuration, needed if cached image is a Volatile Image. Used as part of cache key
* @param w The image width, used as part of cache key
* @param h The image height, used as part of cache key
* @param scale The image scale factor, used as part of cache key
* @return true if the image could be cached, false otherwise.
*/
public boolean setImage(final Image image,
final GraphicsConfiguration config, final int w, final int h,
final int scale, final JRSUIState state) {
if (state.is(JRSUIConstants.Animating.YES)) {
return false;
}
final int hash = hash(config, w, h, scale, state);
lock.writeLock().lock();
try {
PixelCountSoftReference ref = map.get(hash);
// check if currently in map
if (ref != null && ref.get() == image) return true;
// clear out old
if (ref != null) {
currentPixelCount -= ref.pixelCount;
map.remove(hash);
}
// add new image to pixel count
final int newPixelCount = image.getWidth(null) * image.getHeight(null);
currentPixelCount += newPixelCount;
// clean out lost references if not enough space
if (currentPixelCount > maxPixelCount) {
while ((ref = (PixelCountSoftReference)referenceQueue.poll()) != null) {
//reference lost
map.remove(ref.hash);
currentPixelCount -= ref.pixelCount;
}
}
// remove old items till there is enough free space
if (currentPixelCount > maxPixelCount) {
final Iterator<Map.Entry<Integer, PixelCountSoftReference>> mapIter = map.entrySet().iterator();
while ((currentPixelCount > maxPixelCount) && mapIter.hasNext()) {
final Map.Entry<Integer, PixelCountSoftReference> entry = mapIter.next();
mapIter.remove();
final Image img = entry.getValue().get();
if (img != null) img.flush();
currentPixelCount -= entry.getValue().pixelCount;
}
}
// finally put new in map
map.put(hash, new PixelCountSoftReference(image, referenceQueue, newPixelCount, hash, config, w, h, scale, state));
return true;
} finally {
lock.writeLock().unlock();
}
}
private static int hash(final GraphicsConfiguration config, final int w,
final int h, final int scale,
final JRSUIState state) {
int hash = config != null ? config.hashCode() : 0;
hash = 31 * hash + w;
hash = 31 * hash + h;
hash = 31 * hash + scale;
hash = 31 * hash + state.hashCode();
return hash;
}
/**
* Extended SoftReference that stores the pixel count even after the image
* is lost.
*/
private static class PixelCountSoftReference extends SoftReference<Image> {
// default access, because access to these fields shouldn't be emulated
// by a synthetic accessor.
final int pixelCount;
final int hash;
// key parts
private final GraphicsConfiguration config;
private final int w;
private final int h;
private final int scale;
private final JRSUIState state;
PixelCountSoftReference(final Image referent,
final ReferenceQueue<? super Image> q, final int pixelCount,
final int hash, final GraphicsConfiguration config, final int w,
final int h, final int scale, final JRSUIState state) {
super(referent, q);
this.pixelCount = pixelCount;
this.hash = hash;
this.config = config;
this.w = w;
this.h = h;
this.scale = scale;
this.state = state;
}
boolean equals(final GraphicsConfiguration config, final int w,
final int h, final int scale, final JRSUIState state) {
return config == this.config && w == this.w && h == this.h
&& scale == this.scale && state.equals(this.state);
}
}
// /** Gets the rendered image for this painter at the requested size, either from cache or create a new one */
// private VolatileImage getImage(GraphicsConfiguration config, JComponent c, int w, int h, Object[] extendedCacheKeys) {
// VolatileImage buffer = (VolatileImage)getImage(config, w, h, this, extendedCacheKeys);
//
// int renderCounter = 0; // to avoid any potential, though unlikely, infinite loop
// do {
// //validate the buffer so we can check for surface loss
// int bufferStatus = VolatileImage.IMAGE_INCOMPATIBLE;
// if (buffer != null) {
// bufferStatus = buffer.validate(config);
// }
//
// //If the buffer status is incompatible or restored, then we need to re-render to the volatile image
// if (bufferStatus == VolatileImage.IMAGE_INCOMPATIBLE || bufferStatus == VolatileImage.IMAGE_RESTORED) {
// // if the buffer isn't the right size, or has lost its contents, then recreate
// if (buffer != null) {
// if (buffer.getWidth() != w || buffer.getHeight() != h || bufferStatus == VolatileImage.IMAGE_INCOMPATIBLE) {
// // clear any resources related to the old back buffer
// buffer.flush();
// buffer = null;
// }
// }
//
// if (buffer == null) {
// // recreate the buffer
// buffer = config.createCompatibleVolatileImage(w, h, Transparency.TRANSLUCENT);
// // put in cache for future
// setImage(buffer, config, w, h, this, extendedCacheKeys);
// }
//
// //create the graphics context with which to paint to the buffer
// Graphics2D bg = buffer.createGraphics();
//
// //clear the background before configuring the graphics
// bg.setComposite(AlphaComposite.Clear);
// bg.fillRect(0, 0, w, h);
// bg.setComposite(AlphaComposite.SrcOver);
// bg.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
//
// // paint the painter into buffer
// paint0(bg, c, w, h, extendedCacheKeys);
// //close buffer graphics
// bg.dispose();
// }
// } while (buffer.contentsLost() && renderCounter++ < 3);
//
// // check if we failed
// if (renderCounter >= 3) return null;
//
// return buffer;
// }
}

3
jdk/src/macosx/classes/com/apple/laf/ScreenMenu.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,6 +36,7 @@ import sun.awt.SunToolkit;
import sun.lwawt.LWToolkit; import sun.lwawt.LWToolkit;
import sun.lwawt.macosx.*; import sun.lwawt.macosx.*;
@SuppressWarnings("serial") // JDK implementation class
final class ScreenMenu extends Menu final class ScreenMenu extends Menu
implements ContainerListener, ComponentListener, implements ContainerListener, ComponentListener,
ScreenMenuPropertyHandler { ScreenMenuPropertyHandler {

3
jdk/src/macosx/classes/com/apple/laf/ScreenMenuBar.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -33,6 +33,7 @@ import java.util.*;
import javax.swing.*; import javax.swing.*;
@SuppressWarnings("serial") // JDK implementation class
public class ScreenMenuBar extends MenuBar implements ContainerListener, ScreenMenuPropertyHandler, ComponentListener { public class ScreenMenuBar extends MenuBar implements ContainerListener, ScreenMenuPropertyHandler, ComponentListener {
static boolean sJMenuBarHasHelpMenus = false; //$ could check by calling getHelpMenu in a try block static boolean sJMenuBarHasHelpMenus = false; //$ could check by calling getHelpMenu in a try block

3
jdk/src/macosx/classes/com/apple/laf/ScreenMenuItem.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -34,6 +34,7 @@ import javax.swing.plaf.ComponentUI;
import sun.lwawt.macosx.CMenuItem; import sun.lwawt.macosx.CMenuItem;
@SuppressWarnings("serial") // JDK implementation class
final class ScreenMenuItem extends MenuItem implements ActionListener, ComponentListener, ScreenMenuPropertyHandler { final class ScreenMenuItem extends MenuItem implements ActionListener, ComponentListener, ScreenMenuPropertyHandler {
ScreenMenuPropertyListener fListener; ScreenMenuPropertyListener fListener;
JMenuItem fMenuItem; JMenuItem fMenuItem;

3
jdk/src/macosx/classes/com/apple/laf/ScreenMenuItemCheckbox.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,6 +36,7 @@ import com.apple.laf.AquaMenuItemUI.IndeterminateListener;
import sun.lwawt.macosx.*; import sun.lwawt.macosx.*;
@SuppressWarnings("serial") // JDK implementation class
final class ScreenMenuItemCheckbox extends CheckboxMenuItem implements ActionListener, ComponentListener, ScreenMenuPropertyHandler, ItemListener { final class ScreenMenuItemCheckbox extends CheckboxMenuItem implements ActionListener, ComponentListener, ScreenMenuPropertyHandler, ItemListener {
JMenuItem fMenuItem; JMenuItem fMenuItem;
MenuContainer fParent; MenuContainer fParent;

22
jdk/src/macosx/classes/sun/lwawt/LWWindowPeer.java
View File

@ -685,7 +685,7 @@ public class LWWindowPeer
public void notifyNCMouseDown() { public void notifyNCMouseDown() {
// Ungrab except for a click on a Dialog with the grabbing owner // Ungrab except for a click on a Dialog with the grabbing owner
if (grabbingWindow != null && if (grabbingWindow != null &&
grabbingWindow != getOwnerFrameDialog(this)) !grabbingWindow.isOneOfOwnersOf(this))
{ {
grabbingWindow.ungrab(); grabbingWindow.ungrab();
} }
@ -780,7 +780,7 @@ public class LWWindowPeer
// Ungrab only if this window is not an owned window of the grabbing one. // Ungrab only if this window is not an owned window of the grabbing one.
if (!isGrabbing() && grabbingWindow != null && if (!isGrabbing() && grabbingWindow != null &&
grabbingWindow != getOwnerFrameDialog(this)) !grabbingWindow.isOneOfOwnersOf(this))
{ {
grabbingWindow.ungrab(); grabbingWindow.ungrab();
} }
@ -1235,6 +1235,17 @@ public class LWWindowPeer
changeFocusedWindow(activate, null); changeFocusedWindow(activate, null);
} }
private boolean isOneOfOwnersOf(LWWindowPeer peer) {
Window owner = (peer != null ? peer.getTarget().getOwner() : null);
while (owner != null) {
if ((LWWindowPeer)owner.getPeer() == this) {
return true;
}
owner = owner.getOwner();
}
return false;
}
/* /*
* Changes focused window on java level. * Changes focused window on java level.
*/ */
@ -1266,7 +1277,7 @@ public class LWWindowPeer
// - when the opposite (gaining focus) window is an owned/owner window. // - when the opposite (gaining focus) window is an owned/owner window.
// - for a simple window in any case. // - for a simple window in any case.
if (!becomesFocused && if (!becomesFocused &&
(isGrabbing() || getOwnerFrameDialog(grabbingWindow) == this)) (isGrabbing() || this.isOneOfOwnersOf(grabbingWindow)))
{ {
if (focusLog.isLoggable(PlatformLogger.Level.FINE)) { if (focusLog.isLoggable(PlatformLogger.Level.FINE)) {
focusLog.fine("ungrabbing on " + grabbingWindow); focusLog.fine("ungrabbing on " + grabbingWindow);
@ -1285,6 +1296,11 @@ public class LWWindowPeer
postEvent(windowEvent); postEvent(windowEvent);
} }
/*
* Retrieves the owner of the peer.
* Note: this method returns the owner which can be activated, (i.e. the instance
* of Frame or Dialog may be returned).
*/
static LWWindowPeer getOwnerFrameDialog(LWWindowPeer peer) { static LWWindowPeer getOwnerFrameDialog(LWWindowPeer peer) {
Window owner = (peer != null ? peer.getTarget().getOwner() : null); Window owner = (peer != null ? peer.getTarget().getOwner() : null);
while (owner != null && !(owner instanceof Frame || owner instanceof Dialog)) { while (owner != null && !(owner instanceof Frame || owner instanceof Dialog)) {

3
jdk/src/macosx/classes/sun/lwawt/macosx/CCustomCursor.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -28,6 +28,7 @@ package sun.lwawt.macosx;
import java.awt.*; import java.awt.*;
import java.awt.image.BufferedImage; import java.awt.image.BufferedImage;
@SuppressWarnings("serial") // JDK implementation class
public class CCustomCursor extends Cursor { public class CCustomCursor extends Cursor {
static Dimension sMaxCursorSize; static Dimension sMaxCursorSize;
static Dimension getMaxCursorSize() { static Dimension getMaxCursorSize() {

28
jdk/src/macosx/classes/sun/lwawt/macosx/CDataTransferer.java
View File

@ -52,7 +52,9 @@ public class CDataTransferer extends DataTransferer {
"RICH_TEXT", "RICH_TEXT",
"HTML", "HTML",
"PDF", "PDF",
"URL" "URL",
"PNG",
"JFIF"
}; };
static { static {
@ -74,8 +76,8 @@ public class CDataTransferer extends DataTransferer {
public static final int CF_HTML = 5; public static final int CF_HTML = 5;
public static final int CF_PDF = 6; public static final int CF_PDF = 6;
public static final int CF_URL = 7; public static final int CF_URL = 7;
public static final int CF_PNG = 10; public static final int CF_PNG = 8;
public static final int CF_JPEG = 11; public static final int CF_JPEG = 9;
private CDataTransferer() {} private CDataTransferer() {}
@ -204,20 +206,9 @@ public class CDataTransferer extends DataTransferer {
return handler; return handler;
} }
private native byte[] imageDataToPlatformImageBytes(int[] rData, int nW, int nH);
@Override @Override
protected byte[] imageToPlatformBytes(Image image, long format) { protected byte[] imageToPlatformBytes(Image image, long format) {
int w = image.getWidth(null); return CImage.getCreator().getPlatformImageBytes(image);
int h = image.getHeight(null);
BufferedImage bimage = new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB_PRE);
Graphics g = bimage.getGraphics();
g.drawImage(image, 0, 0, w, h, null);
g.dispose();
Raster raster = bimage.getRaster();
DataBuffer buffer = raster.getDataBuffer();
return imageDataToPlatformImageBytes(((DataBufferInt)buffer).getData(),
raster.getWidth(),
raster.getHeight());
} }
private static native String[] nativeDragQueryFile(final byte[] bytes); private static native String[] nativeDragQueryFile(final byte[] bytes);
@ -228,14 +219,9 @@ public class CDataTransferer extends DataTransferer {
return nativeDragQueryFile(bytes); return nativeDragQueryFile(bytes);
} }
private native Image getImageForByteStream(byte[] bytes);
/**
* Translates a byte array which contains
* platform-specific image data in the given format into an Image.
*/
@Override @Override
protected Image platformImageBytesToImage(byte[] bytes, long format) throws IOException { protected Image platformImageBytesToImage(byte[] bytes, long format) throws IOException {
return getImageForByteStream(bytes); return CImage.getCreator().createImageFromPlatformImageBytes(bytes);
} }
@Override @Override

Some files were not shown because too many files have changed in this diff Show More