Skip to content

Commit

Permalink
Replace all occurrences of JavaMail keyword
Browse files Browse the repository at this point in the history
Signed-off-by: Alexander Pinchuk <alexander.v.pinchuk@gmail.com>
  • Loading branch information
avpinchuk committed Mar 18, 2023
1 parent 03b85d1 commit 0fa5bfa
Show file tree
Hide file tree
Showing 21 changed files with 103 additions and 103 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.Matchers.contains;

public class JavaMailITest extends RestTestBase {
public class MailITest extends RestTestBase {

private static final String URL_CREATE_MAIL_RESOURCE = "/domain/resources/create-mail-resource";

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ this release of the {productName} 7 software.
* <<Connectivity Subcommands>>
* <<Domain Subcommands>>
* <<Internet Connectivity Subcommands>>
* <<JavaMail Subcommands>>
* <<Jakarta Mail Subcommands>>
* <<JMS Subcommands>>
* <<JNDI Subcommands>>
* <<JVM Subcommands>>
Expand Down Expand Up @@ -502,22 +502,22 @@ xref:reference-manual.adoc#list-virtual-servers[`list-virtual-servers`]::
procedural information in this guide, see xref:http_https.adoc#to-list-virtual-servers[To
List Virtual Servers].

[[javamail-subcommands]]
[[jakarta-mail-subcommands]]

=== JavaMail Subcommands
=== Jakarta Mail Subcommands

xref:reference-manual.adoc#create-mail-resource[`create-mail-resource`]::
Creates a JavaMail session resource. Supported in remote mode only.
Creates a Jakarta Mail session resource. Supported in remote mode only.
For procedural information in this guide, see
xref:javamail.adoc#to-create-a-javamail-resource[To Create a JavaMail Resource].
xref:jakarta-mail.adoc#to-create-a-jakarta-mail-resource[To Create a Jakarta Mail Resource].
xref:reference-manual.adoc#delete-mail-resource[`delete-mail-resource`]::
Deletes a JavaMail session resource. Supported in remote mode only.
Deletes a Jakarta Mail session resource. Supported in remote mode only.
For procedural information in this guide, see
xref:javamail.adoc#to-delete-a-javamail-resource[To Delete a JavaMail Resource].
xref:jakarta-mail.adoc#to-delete-a-jakarta-mail-resource[To Delete a Jakarta Mail Resource].
xref:reference-manual.adoc#list-mail-resources[`list-mail-resources`]::
Creates JavaMail session resources. Supported in remote mode only. For
procedural information in this guide, see xref:javamail.adoc#to-list-mail-resources[To
List JavaMail Resources].
Creates Jakarta Mail session resources. Supported in remote mode only. For
procedural information in this guide, see xref:jakarta-mail.adoc#to-list-mail-resources[To
List Jakarta Mail Resources].

[[jms-subcommands]]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -775,7 +775,7 @@ resources, such as JDBC, is contained in other chapters.

Use the `add-resources` subcommand in remote mode to create the
resources named in the specified XML file. The following resources are
supported: JDBC connection pool and resource, JMS, JNDI, and JavaMail
supported: JDBC connection pool and resource, JMS, JNDI, and Jakarta Mail
resources, custom resource, connector resource and work security map,
admin object, and resource adapter configuration.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,66 +1,66 @@
title=Administering the JavaMail Service
title=Administering the Jakarta Mail Service
next=jms.adoc
prev=orb.adoc
~~~~~~

= Administering the JavaMail Service
= Administering the Jakarta Mail Service

[[administering-the-javamail-service]]
== 16 Administering the JavaMail Service
[[administering-the-jakarta-mail-service]]
== 16 Administering the Jakarta Mail Service

{productName} includes the JavaMail API along with JavaMail service
{productName} includes the Jakarta Mail API along with Jakarta Mail service
providers that allow an application component to send email
notifications over the Internet and to read email from IMAP and POP3
mail servers.

The following topics are addressed here:

* <<About JavaMail>>
* <<Administering JavaMail Resources>>
* <<About Jakarta Mail>>
* <<Administering Jakarta Mail Resources>>

Instructions for accomplishing the tasks in this chapter by using the
Administration Console are contained in the Administration Console
online help.

[[about-javamail]]
[[about-jakarta-mail]]

=== About JavaMail
=== About Jakarta Mail

The JavaMail API is a set of abstract APIs that model a mail system. The
JavaMail API provides a platform-independent and protocol-independent
The Jakarta Mail API is a set of abstract APIs that model a mail system. The
Jakarta Mail API provides a platform-independent and protocol-independent
framework to build mail and messaging applications and provide
facilities for reading and sending electronic messages. Service
providers implement particular protocols. Using the API you can add
email capabilities to your applications. JavaMail provides access from
email capabilities to your applications. Jakarta Mail provides access from
Java applications to Internet Message Access Protocol (IMAP) and Simple
Mail Transfer Protocol (SMTP) capable mail servers on your network or
the Internet. The API does not provide mail server functionality; you
must have access to a mail server to use JavaMail.
must have access to a mail server to use Jakarta Mail.

The JavaMail API is implemented as an optional package in the Java
The Jakarta Mail API is implemented as an optional package in the Java
platform and is also available as part of the Jakarta EE platform.

To learn more about the JavaMail API, consult the
http://www.oracle.com/technetwork/java/javamail/[JavaMail web site] .
To learn more about the Jakarta Mail API, consult the
https://jakartaee.github.io/mail-api/[Jakarta Mail web site] .

[[administering-javamail-resources]]
[[administering-jakarta-mail-resources]]

=== Administering JavaMail Resources
=== Administering Jakarta Mail Resources

When you create a mail session, the server-side components and
applications are enabled to access JavaMail services with JNDI, using
applications are enabled to access Jakarta Mail services with JNDI, using
the session properties you assign for them. When creating a mail
session, you can designate the mail hosts, the transport and store
protocols, and the default mail user so that components that use
JavaMail do not have to set these properties. Applications that are
Jakarta Mail do not have to set these properties. Applications that are
heavy email users benefit because {productName} creates a single
session object and makes the session available to any component that
needs it.

JavaMail settings such as the following can be specified:
Jakarta Mail settings such as the following can be specified:

* JNDI Name. The unique name for the mail session. Use the naming
sub-context prefix mail/ for JavaMail resources. For example:
sub-context prefix mail/ for Jakarta Mail resources. For example:
`mail/MySession`
* Mail Host. The host name of the default mail server. The connect
methods of the store and transport objects use this value if a
Expand All @@ -77,22 +77,22 @@ at this time

The following topics are addressed here:

* <<To Create a JavaMail Resource>>
* <<To List JavaMail Resources>>
* <<To Update a JavaMail Resource>>
* <<To Delete a JavaMail Resource>>
* <<To Create a Jakarta Mail Resource>>
* <<To List Jakarta Mail Resources>>
* <<To Update a Jakarta Mail Resource>>
* <<To Delete a Jakarta Mail Resource>>

[[to-create-a-javamail-resource]]
[[to-create-a-jakarta-mail-resource]]

==== To Create a JavaMail Resource
==== To Create a Jakarta Mail Resource

Use the `create-mail-resource` subcommand in remote mode to create a
JavaMail session resource. The JNDI name for a JavaMail session resource
Jakarta Mail session resource. The JNDI name for a Jakarta Mail session resource
customarily includes the mail/ naming subcontext, For example:
`mail/MyMailSession.`

1. Ensure that the server is running. Remote subcommands require a running server.
2. Create a JavaMail resource by using the
2. Create a Jakarta Mail resource by using the
xref:reference-manual.adoc#create-mail-resource[`create-mail-resource`] subcommand.
+
Information about the properties for the subcommand is included in this
Expand All @@ -102,9 +102,9 @@ help page.
See xref:domains.adoc#to-restart-a-domain[To Restart a Domain].

[[gipfs]]
Example 16-1 Creating a JavaMail Resource
Example 16-1 Creating a Jakarta Mail Resource

This example creates a JavaMail resource named `mail/MyMailSession`. The
This example creates a Jakarta Mail resource named `mail/MyMailSession`. The
escape character (\) is used in the `--fromaddress` option to
distinguish the dot (.) and at sign (@).

Expand All @@ -122,19 +122,19 @@ typing `asadmin help create-mail-resource` at the command line.

[[to-list-mail-resources]]

==== To List JavaMail Resources
==== To List Jakarta Mail Resources

Use the `list-mail-resources` subcommand in remote mode to list the
existing JavaMail session resources.
existing Jakarta Mail session resources.

1. Ensure that the server is running. Remote subcommands require a running server.
2. List the JavaMail resources by using the
2. List the Jakarta Mail resources by using the
xref:reference-manual.adoc#list-mail-resources[`list-mail-resources`] subcommand.

[[gipfe]]
Example 16-2 Listing JavaMail Resources
Example 16-2 Listing Jakarta Mail Resources

This example lists the JavaMail resources on `localhost`.
This example lists the Jakarta Mail resources on `localhost`.

[source]
----
Expand All @@ -148,19 +148,19 @@ See Also
You can also view the full syntax and options of the subcommands by
typing `asadmin help list-mail-resources` at the command line.

[[to-update-a-javamail-resource]]
[[to-update-a-jakarta-mail-resource]]

==== To Update a JavaMail Resource
==== To Update a Jakarta Mail Resource

1. List the JavaMail resources by using the
1. List the Jakarta Mail resources by using the
xref:reference-manual.adoc#list-mail-resources[`list-mail-resources`] subcommand.
2. Modify the values for the specified JavaMail source by using the
2. Modify the values for the specified Jakarta Mail source by using the
xref:reference-manual.adoc#set[`set`] subcommand.
+
The resource is identified by its dotted name.

[[giwjb]]
Example 16-3 Updating a JavaMail Resource
Example 16-3 Updating a Jakarta Mail Resource

This example changes `joeserver` to `joe`.

Expand All @@ -172,31 +172,31 @@ MyMailSession.user=joe
Command set executed successfully.
----

[[to-delete-a-javamail-resource]]
[[to-delete-a-jakarta-mail-resource]]

==== To Delete a JavaMail Resource
==== To Delete a Jakarta Mail Resource

Use the `delete-mail-resource` subcommands in remote mode to delete
a JavaMail session resource.
a Jakarta Mail session resource.

Before You Begin

References to the specified resource must be removed before running the
`delete-mail-resource` subcommands.

1. Ensure that the server is running. Remote subcommands require a running server.
2. List the JavaMail resources by using the
2. List the Jakarta Mail resources by using the
xref:reference-manual.adoc#list-mail-resources[`list-mail-resources`] subcommands.
3. Delete a JavaMail resource by using the
3. Delete a Jakarta Mail resource by using the
xref:reference-manual.adoc#delete-mail-resource[`delete-mail-resource`] subcommands.
4. To apply your changes, restart {productName}.
+
See xref:domains.adoc#to-restart-a-domain[To Restart a Domain].

[[gipcd]]
Example 16-4 Deleting a JavaMail Resource
Example 16-4 Deleting a Jakarta Mail Resource

This example deletes the JavaMail session resource named
This example deletes the Jakarta Mail session resource named
`mail/MyMailSession`.

[source]
Expand Down
2 changes: 1 addition & 1 deletion docs/administration-guide/src/main/asciidoc/jms.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
title=Administering the Java Message Service (JMS)
next=jndi.adoc
prev=javamail.adoc
prev=jakarta-mail.adoc
~~~~~~

= Administering the Java Message Service (JMS)
Expand Down
2 changes: 1 addition & 1 deletion docs/administration-guide/src/main/asciidoc/jndi.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ Table 18-1 JNDI Lookup Names and Their Associated References

|`java:comp/UserTransaction` |UserTransaction references

|`java:comp/env/mail` |JavaMail Session Connection Factories
|`java:comp/env/mail` |Jakarta Mail Session Connection Factories

|`java:comp/env/url` |URL Connection Factories

Expand Down
8 changes: 4 additions & 4 deletions docs/administration-guide/src/main/asciidoc/loe.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -192,10 +192,10 @@ Security Maps for a Connector Connection Pool]
* xref:orb.adoc#gipcm[15-2 Listing IIOP Listeners]
* xref:orb.adoc#giwlj[15-3 Updating an IIOP Listener]
* xref:orb.adoc#giped[15-4 Deleting an IIOP Listener]
* xref:javamail.adoc#gipfs[16-1 Creating a JavaMail Resource]
* xref:javamail.adoc#gipfe[16-2 Listing JavaMail Resources]
* xref:javamail.adoc#giwjb[16-3 Updating a JavaMail Resource]
* xref:javamail.adoc#gipcd[16-4 Deleting a JavaMail Resource]
* xref:jakarta-mail.adoc#gipfs[16-1 Creating a Jakarta Mail Resource]
* xref:jakarta-mail.adoc#gipfe[16-2 Listing Jakarta Mail Resources]
* xref:jakarta-mail.adoc#giwjb[16-3 Updating a Jakarta Mail Resource]
* xref:jakarta-mail.adoc#gipcd[16-4 Deleting a Jakarta Mail Resource]
* xref:jms.adoc#gipbb[17-1 Creating a JMS Host]
* xref:jms.adoc#gipdw[17-2 Listing JMS Hosts]
* xref:jms.adoc#givlz[17-3 Updating a JMS Host]
Expand Down
2 changes: 1 addition & 1 deletion docs/administration-guide/src/main/asciidoc/orb.adoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
type=page
status=published
title=Administering the Object Request Broker (ORB)
next=javamail.html
next=jakarta-mail.html
prev=concurrent.html
~~~~~~

Expand Down
6 changes: 3 additions & 3 deletions docs/administration-guide/src/main/asciidoc/overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -184,9 +184,9 @@ Internet Connectivity::
Object Request Broker (ORB)::
An initial configuration task might involve creating an IIOP listener.
See xref:orb.adoc#administering-the-object-request-broker-orb[Administering the Object Request Broker (ORB)].
JavaMail Service::
An initial configuration task might involve creating a JavaMail
resource. See xref:javamail.adoc#administering-the-javamail-service[Administering the JavaMail
Jakarta Mail Service::
An initial configuration task might involve creating a Jakarta Mail
resource. See xref:jakarta-mail.adoc#administering-the-jakarta-mail-service[Administering the Jakarta Mail
Service].
Java Message Service (JMS)::
Initial configuration tasks might include creating a physical
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1695,7 +1695,7 @@ The following resource types can be application-scoped:
* External JNDI resources
* Custom resources
* Admin object resources
* JavaMail resources
* Jakarta Mail resources

Deployment Descriptor. An application-scoped resource is defined in the
`glassfish-resources.xml` deployment descriptor file. This file is
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -572,7 +572,7 @@ correctly rolled back or committed.
|Java Message Service (JMS) ConnectionFactory, Destination
|No

|JavaMail Session
|Jakarta Mail Session
|No

|Connection Factory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -521,7 +521,7 @@ Application Deployment Guide.

The rest of this section uses an example of a JDBC resource lookup to
describe how to reference resource factories. The same principle is
applicable to all resources (such as JMS destinations, JavaMail
applicable to all resources (such as JMS destinations, Jakarta Mail
sessions, and so on).

The `@Resource` annotation in the application code looks like this:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ layer using the RFC822 and MIME internet standards.
message data and to handle commands intended to interact with that data.

For more information, see
"xref:administration-guide.adoc#administering-the-javamail-service[Administering the Jakarta Mail Service]"
"xref:administration-guide.adoc#administering-the-jakarta-mail-service[Administering the Jakarta Mail Service]"
in {productName} Administration Guide
and the Jakarta Mail specification at
`https://jakarta.ee/specifications/mail`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -785,7 +785,7 @@ correctly rolled back or committed.

|Java Message Service (JMS) ConnectionFactory, Destination |No

|JavaMail Session |No
|Jakarta Mail Session |No

|Connection Factory |No

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,7 @@ standalone Resource Adapter Archive (RAR) modules or included in Jakarta EE
application archives. As RARs, they are deployed like other Jakarta EE
components. {productName} includes evaluation resource adapters that
integrate with popular EIS.
* JavaMail - Through the JavaMail API, applications can connect to a
* Jakarta Mail - Through the Jakarta Mail API, applications can connect to a
Simple Mail Transport Protocol (SMTP) server to send email and to an
IMAP or POP3 server to receive email.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ be correctly rolled back or committed.

** JDBC DataSource
** Java Message Service (JMS) `ConnectionFactory` and `Destination` objects
** JavaMail Session
** Jakarta Mail Session
** Connection Factory
** Administered Objects
** Web service reference +
Expand Down
Loading

0 comments on commit 0fa5bfa

Please sign in to comment.