Suitable for use by subclasses of {@code DatagramSocket} and + * {@code MulticastSocket}, that wish to provide their own complete + * implementation, without delegating to the enclosing {@code impl} class. + * For example: + * + *
{@code
+ * class CustomDatagramSocket extends DatagramSocket {
+ * CustomDatagramSocket() {
+ * super(DatagramSocket.THROWING_DGRM_IMPL);
+ * }
+ *
+ * // override of all methods of DatagramSocket ...
+ * }
+ * }
+ */
+ // TODO: find a better name
+ @SuppressWarnings("deprecation")
+ protected static final DatagramSocketImpl THROWING_DGRM_IMPL = new DatagramSocketImpl() {
+ private final void throwUncheckedIOException() {
+ throw new UncheckedIOException(new IOException("unimplemented"));
+ }
+ @Override protected void create() { throwUncheckedIOException(); }
+ @Override protected void bind(int p, InetAddress a) { throwUncheckedIOException(); }
+ @Override protected void send(DatagramPacket p) { throwUncheckedIOException(); }
+ @Override protected void connect(InetAddress a, int p) { throwUncheckedIOException(); }
+ @Override protected void disconnect() { throwUncheckedIOException(); }
+ @Override protected int getLocalPort() { throwUncheckedIOException(); return 0; }
+ @Override protected FileDescriptor getFileDescriptor() { throwUncheckedIOException(); return null; }
+ @Override protected int peek(InetAddress i) { throwUncheckedIOException(); return 0; }
+ @Override protected int peekData(DatagramPacket p) { throwUncheckedIOException(); return 0; }
+ @Override protected void receive(DatagramPacket p) { throwUncheckedIOException(); }
+ @Override protected void setTTL(byte ttl) { throwUncheckedIOException(); }
+ @Override protected byte getTTL() { throwUncheckedIOException(); return 0; }
+ @Override protected void setTimeToLive(int ttl) { throwUncheckedIOException(); }
+ @Override protected int getTimeToLive() { throwUncheckedIOException(); return 0; }
+ @Override protected void join(InetAddress a) { throwUncheckedIOException(); }
+ @Override protected void leave(InetAddress a) { throwUncheckedIOException(); }
+ @Override protected void joinGroup(SocketAddress a,
+ NetworkInterface b) { throwUncheckedIOException(); }
+ @Override protected void leaveGroup(SocketAddress a,
+ NetworkInterface b) { throwUncheckedIOException(); }
+ @Override protected void close() { throwUncheckedIOException(); }
+ @Override public void setOption(int o, Object v) { throwUncheckedIOException(); }
+ @Override public Object getOption(int o) { throwUncheckedIOException(); return null; }
+ @Override protected DatagramSocketImpl.
*/
+ @SuppressWarnings("deprecation")
static DatagramSocketImpl createDatagramSocketImpl(boolean isMulticast /*unused on unix*/)
throws SocketException {
if (prefixImplClass != null) {
try {
- @SuppressWarnings("deprecation")
DatagramSocketImpl result = (DatagramSocketImpl)prefixImplClass.newInstance();
return result;
} catch (Exception e) {
--- /dev/null 2020-02-14 09:52:19.000000000 +0000
+++ new/test/jdk/java/net/DatagramSocketImpl/NoWarningSubclasses.java 2020-02-14 09:52:18.000000000 +0000
@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 1998, 2019, 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.
+ */
+
+/**
+ * @test
+ * @bug 8765432
+ * @summary Ensures that there is a warning-free way to compile subclasses
+ * of DatagramSocket and MulticastSocket
+ * @compile -Xlint:all -Werror NoWarningSubclasses.java
+ */
+
+import java.net.DatagramSocket;
+import java.net.MulticastSocket;
+
+public class NoWarningSubclasses {
+
+ static class TestDatagramSocket extends DatagramSocket {
+ TestDatagramSocket() {
+ super(DatagramSocket.THROWING_DGRM_IMPL);
+ }
+ }
+
+ static class TestMulticastSocket extends MulticastSocket {
+ TestMulticastSocket() {
+ super(DatagramSocket.THROWING_DGRM_IMPL);
+ }
+ }
+}